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stay In Control Wherever You Go. 



Timbuktu Pro 

Whether you're at home or at work, Timbuktu Pro allows you to operate distant 
computers as if you were sitting in front of them, transfer files or folders quickly 
and easily, and communicate by instant message, text chat, or voice Intercom. 
http://www.timbuktupro.com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
computers. Inventory computers, software and devices on your network; distribute 
software; configure remote computers; and create custom reports on the fly. 
http://www.netoctopus.com 

Learn more, try it, or buy it online. Call us at 1-800-485-5741. 
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Today's database demands are often too a>mplcx Ibr traditional database servers. 
The functionality and precise level of control you need is simply not available. 
Perhaps you need alternate sort criteria for your data or a s^Kcial twist in the 
threading or coiniiiunication logic. 

FairCom’s c-iree" Server SDK allows you to create a customized, 
indusLrial-sirengih server designed for your particular needs. Use 
FairCom’s kernel, with over 20 years of proven stability, or override 
functionality within specific subsystems to implement yt>ur own 
subtleties. Move your application s data I/O functions to the 
server-side to decrease network traffic and increase 
performance! 

FairCom’s c-tree Server SDK is used by companies 
worldwide such as Software AG and Citibank^ It*s 
integrated seamlessly into c-trec Plus and includes 
complete source code to the server mainline and all the 
interface subsystems to the c-trec Server, And 
best of all, once you've created your unique, 
customized server, it is easy to install and 
administer: DBA required! 


tiiihaiice our server with your own 
custom server-side functionality 

Move functioiiaJily from the clicnt-sidc to 
the server-side to reduce network traffic 
and increase performance 

Modify or replace entire server 
subsystems 

Complete source for the server 
mainline, key server 
subsystems, and clicnt-sidc 

Flexible OHM licensing 


Visit www.fairGom.com/efi/mt/sdk today to take control 

of your server! 

FairCom* 

USA 

573,445,6833 

EUROPE 

+39,035.773.464 

JAPAN 

+^1.59,229.7504 

WWW,fair* Gam.com 

BRAZIL 

+55.11..3872,9802 

1 DBIVIS Since 1S7S « SOO«e34,S1SO * 

info@feircam,com | 


□tftcr company umJ frofluct ww* srt mgwrwj or of Uwr respeow B apoe FaffCom Corporobon 
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Getting Started: 

More Fun With AppleScript 


In last month's column, we installed Script Menu to help 
us organ be our scripts, and then siaried digging into the 
Finder's AppleScri[>l dictionary. Fantastic stuin Ilopclully, 
youVe had a chance to play. If not, launch Script Editor, select 
Library from the Window menu, then double-click on the 
Finder entry in the fJhraiy list. A Finder dictionary window 
should appear. 

Click on the line in the left pane Uiheied Finder Bmics. 
The classes and c'ommands associated with the Finder Bmic.s 
ApplcScri[)t suite wall appear (see Figure 1). Notice that the 
binder Basks are divided into Froperdes and Flernenis^ 'I’hink 
of properties as class data and the elements as objects within 
the class. 


For example, go into the Script Editor and type this script: 

tell application “Finder” 
get name 
end tell 

When you run this script, here's whai appears in the 
results field: 

"FindGc'’ 

'rhis is the value of the name property of the Finder. If 
you are running Panther, here’s the result of the command 
gc/ version: 


.... 

T Suttt 

C&mHVwdi, 

liiMjfiitSHl 


FlntJ^r 

Finder Ba-sics: Cammttniy-Hseif tinekr tmmtwttfia uwd 
object classes 


p- cowimKdt 
f Ctnilaiirkffi'i ilrpd lo<dcr» 
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Tnui 
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TWindOiV 
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r-inacr winiKiw tunutL huim, it) iej 
clipping wiitfipw 1»5, (i-Vi In iMun; 

cupboard rcferetice - (fiOTAVAtlAOLB VF7? Fitter’s 
eheixara wtntiovt 

name tcxEti'Ul fptdw'r 

viiibte bcMie^an Je rhiff 't 

frontmoxt bcK>i«Pn ■ ■ Js i^n? fOttkf iffc frnrrtfnosi 
seJeellan ruference - tittt wNrcT/wri Jrt iHe fronttjta'il fun!ttr 
Invfirtipn louv^on rerer^nm* tr-n] - file ticfhfpmtf# w ffhah j 

tfitdiff mwiiltf tf "Ww ftiUkt* IrVM t^l&l 

proffuct vt^^3Jon Unicddt' teyt j|irt| fftft VijrijtfW] (W fftc Sy^Fem 
softvtifte n/ffttJrtu o^i fflfs compufijr 

versfflTi UnicCMfetext |ri>| ^ t.hiMivstod cT fbc fifidbr 
startup dla^h dliiic |ro| f.fic crvinup ^xft 
desktop de^litop'Ciblect |.i^| tfie destilop 

trash trash'Object I r^l (herrpjtb 
home Meter |(tv| - tbc (fumi-dirKftVK 
Finder preferences preferances If/wf (fiOr AvAttADLE WT) 

Vatrajs pimpfcncef fflaf appfy to tffo rtn-aer it j 


Itant frv MHih'CK ■Hiinn'mi'lrr jwrlAn iHiTh%aE»npr tn vknh'ni't 

.ajljfvli^ 

contO'Incr ii> twMcnv nKlcv.ity n»i)r 
disk fcy tiHiiKirk: index.ay iwmc. nx' tb 
fEildar try (luinerk: ImkSi.lff SoWc. Irt JT) 
nie liv iMSKTk liiili-x. by luifla: 
alJaa fils br miinrlh Iiklfi.hi' luikv 
applkatlun f^le by ■Binrn.- jnlet In wv by lb 
docuiniLitt file by nspKtk Initex.in mistc 
Internet IpcsIIiki ffle i»y Mwrk liwtex.lvy luune 
cUpp|n9 by EiifiEhrrk Li«kt.by njiik 

package iry iisiiuikuMki.lvy 4uiiv 

window by luinyrfk iBikx. bv BiiiiL- 


”10.3” 

1 lere's an interesting one. First, do a ge/ starlup disk: 

startup disk of application “Finder"’ 

Ntiw do name of startup disk 

“Macintosh Ml)'" 

Sec the difference? Starttip disk is a reference to the 
sLartiip disk, whereas name of si art up disk is a string 
containing the name of the startup disk. If you look in Figure 
1, you'll see that startup disk is of type disk i'he disk class Is 
defined in the Contaimus andfoUlers suite. The class is showm 
in Figure 2. Notice that the dictionary shows the plural form of 
disk as disks. Hie dictionary also shows the elements and 
properties of the disk class. 


Fij^iire 1. The Finder BcLsks diciionaryf entries. 


Dave Mark is a long-time Mac developer and luithoi and has written a niimher of books on .Macintosh development, including Ijearn C on the 
Macintosh, tj^arn C++ on the Macinto.'ih. and We Macintosh Pro^ramminif Primer series. Be sure to check out Dave's w'eh site at 
http:y/www.spiderworks,com. 
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If a picture is worth a thousand words, 
imagine how priceless a movie would be 



Snapz Pro X 2*0 allows you to effortlessly record anything on your screen, saving it as a QuickTimcXK) 
movie that tan l:x} emailed, put up on the web, or [.msscxJ around however you please. 
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- [ Stnpz ■ PrtWtnttS About 
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Movie... 1 


C^Lj:re Opuoni._ _ _ _ 

Sand u: Op*" Mvifi# 

Q Cfioow tm iwmo 
Q Stick. Around 


Why take a static, screenshot when Snapz Pro X 2.0 makes creating a movie just as easy? 
Snapz Pro X 2,0 that, and so much more ■“ what a difference a version makes! 
Download a free demo version from our web site today and see for yourself: 

ht(:p://www. AmbrosiaSW.com/ 
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Snapz Pro X 2.0 

AMBROSIA* 

SOFTWARE INC 


. *0 0 

min/rn. 
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Snapz Pro X, Ambrosia Software, Inc., and the Ambrosia Software logo are rr^gisterccJ trademarks of Ambrosia Software, Inc. 
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Figure 2 Vje disk ciass nilries oflhe 
CcnUaiticrs and /aiders suile. 


Try the coiiiniand get formai of sUnHip disk, Reiiieniber, 
format is a property of the disk class and startup dhk is dehntxl 
as bein^ of class disk. Mere's tlie result on my Mac^: 


Mac OS BxtentJed format 


Now try gai jountaiing enahfed of siarltip disk. Here's 
the result: 

true 


As you might expect, tj(x)lean properties return eiilier tine or 
false. The t oinnund get ignore pht^ileges (fstaHup disk returns: 

falfse 


Finder Basics - Elements 

Go back to Figure 1 and take a look at the elements in the 
Finder Basics .suite. These are the o!>jects iliai you might expect 
the Finder to encounter. What do you think the result will be of 
running this script: 


tell application ’’Finder" 
get Items 
end tell 


of doaktqp of appUcation ’’Findor", folder "IJI Element 
Inspectotr” of desktop of application “Finder’’, alias file 
“Warcraft lil’' of desktop of application "Finder”, folder 
“weddiiig_pics” of desktop of application "Fitider“, docLimeiJt 
file ■‘Xcods notes” of desktop of application “Finder”! 

Lcx>k tlmjugh iliis list of iienis. Note the curly braces, necessary 
to making this a proper list. Take a look at the nomenciatiire, 
especially the use of the wort! "of all over the place. Think 
conUiiners/endasurcs, items within iteuis witliin items. 

Figure 2 shows tlie listing of the Finder items suite in a 
dictionary window. Check out the list of prcjperties. Note that an 
item has an index. Look in the list of items in the previous list, 
relunied by the get items command. What do you think will 
happen when I rui the command ge/ item 2, Here's my result: 


disk "Macintosb HIV’ of application “Finder" 


J^FIrtdtr_ . ^ __._^_,.. 

Flndfritt'itt^: Cuifiimndx used with file system isetm. and basi 
item dcMtiitWii 
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figure .i The item class in the Finder items suite. 


mme __ 

Swka 
KCanuiurult 
p'Finatr lnfHi 

HSSQSCSSSHBI 

T CLu L Vh 
Htffl 

PtomnUktli 
tCwdakim jnd Fo 
bCifttiM 
VFUfti 
PClKiMn 

cttim 
k- cutili 
^tfqaiy »iUr* 
b-Tvdt Otiirtiivm 


As you miglit exj>cct, get item 2 returns the second item in 
the list returned by get Heim. Now, what do you suppose you'd 
get from this cc)mniand: 

get containfir of item 2; 


ft helps to have a sease of the item class. An item is 
basically a generic object - pretty much anything that could exist 
in a Finder window' or on the desktop. Here’s the result I got 
when 1 ran the scrip! on my Mac: 

I startup disk of appllcwtinn “Finder", disk “Macintosh HD" of 
application “Finder", folder "AE Monitor 1,0* of desktop of 
application “Finder"* document file "DSC_0/5l,JPG" of demklop 
of application “Finder", folder "InDesign CS Example Scripts" 


In my case, I got: 

folder "Dave Kark*s Coraptiter" of application “FindEr" 

Brave New Make 

So far, all we’ve done is suck information out of the Finder. 
Let's try making something. 
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In the Finder's dictionary window, click on the Commands 
line in the Standard Suite. The commands supponed by all 
sulxst^<|uenl suiles are listed. One of these is the make command. 
The details are shown in Figure 4. 


try 

raaks foldsr vith properties 1 namo^ ”blap” ] 
on error error_mes.‘>age 

display dialog error_fflesB£ige 
end try 
end tell 
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Figure 4 Dctaibi on the make command. 


[ lere's a script to create a new' folder at the current insertion 
kxration (the desktop). 


Running this script produces the dialog shown in Figure 6. 
Much belter. Now the script uses a block and a 
coiTesponding on enxir block to pass the incoming error 
message to die display dialog command. 


The operation could not be completed because 
there is already an item with that name. 

Cancel ) 


Figure d A simple error dialog. 


tell application "‘Finder" 

make new folder wEth properties I ruime: "blap" 1 
end tell 

This tells the Finder to create a new folder at the cunent 
insertion kxarion (since I didn't specify a new location) with the 
specified properties. Since 1 only specified a single properly, this 
will be [iretry simple. [ ran this script and a new folder named 
“blap’' appeared on my desktop. Here's the result rettirned by 
my script; 

folder ’^blap" of folder "Desktop"* of folder “davemark" of 
foldt’r *Usor.^" of st^artup disk of application "Finder" 

Does this make sen.se? You can see the containment 
liierarchy as it walks its w'uy out frojn die new fcjlder to the top 
of my hard drive and Finder itself 

Now' that *'blap'’ exists, let's try running the st:ript again, 
firm. As you can see in Figure 5, we got an error, telling us that 
the folder already exists. 


1 leie's die result of nmiiing this saipt (I clicked die OK button): 
I button returned: "OK"* I 

Till Next Mojnth.-, 

Flopehilly, you are gerting a hit more familiar with the 
A[)pleScripi Finder dictionary and the way you can take 
advantage of properties, ciements, and commands. Now that 
you have a sense of the Finder, open up some other dictionaries. 
A great one to play with is the TextEdit dictionary. A lovely place 
to create text elements and copy them to tile clipboard for use 
in otlier applications. Try your hand at manipulating TextEdit. 
See what you can do with it. 

We tPill return to AppleScript at some point (I love it too 
much nor to) but next month's column is going back to Cocoa. 
1 am heading down to Atlanta to Aaron Hillegass’ Dig Nerd 
Ranch for a week of intensive Cocoa training. I am excited 
about this. Model View Controller, Model View Controller. See 
you next month! © 



AppleScript Error 

Ftnd^r 90T an The operation could mi be 
completed because there is already arv item that 
tiame. 



Figure 5- An error is reported luhen 1 try creating 
a folder ihai already exists. Hrm. 

Having Script Editor report the error is very Liseful if you are 
testing your script or just playing. Bui if you deliver this script as 
a compiled entity to a user, you'if want the program to handle 

the errors itself, Here's a new version of the script: 
tell application "Finder" 



GraphicConverter converts 
pictures to different 
formats. Also it contains 
many useful features for 
picture manipulation. 


See wwwJemkesoft.eom 

for more information. 


I’Kimi'ARY 2004 • MacTech 


Your Fiiist MySQI, Data Entry 













MAC OS X 
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SECRETS 


By Scott Knaster 

Ship It! 

Distributing Your Software, Part 2 


In our Inst thrilling insiallinent (or was it a thrilling 
inslallciiiort'^), we discussed the simplest method of disirihuiion 
for yoLir Mac OS X software: disk images. We talked about Ltsing 
Disk Copy or Disk Utility to make a disk image^ and we 
described the relatively recent technology of Internet-enahling a 
disk itrtage so tiiai it cleans up after itself when users downioad 
it in Safajl 

When yoti disirihiiie software on a disk image, there is no 
actual installing taking place. Users simply drag and drop files 
onto their hard disks. That's the great strength and weakness of 
disk images: they're easy for you to make and easy for users to 
figure out, but you can quickly run into their limitations. For 
example, wliat if you need to make sure files end up in specific 
places on the disk? What al^oul checking the progress of the 
insUillalion and taking some action ba.sed on whafs liappening? 
Most commercial applications need to do things like this when 
they're installed. For more control of the installation process, 
Apple provides the Package Maker and Installer tools. 

Meet Your Maker 

PackageMaker is an application that comes with Mac OS X. 
You use PackageMaker to create packages, whicli are documents 
with extension .pkg that contain files to be installed and related 
files used during the in.stallation. An Apple application called 
Installer reads the information Iroiti a package and perfonns the 
installation. 

The TWO biggest tricks PackageMaker installations can do 
dial disk images can't are installing files anywhere in tlie system, 
and running scripts while the itisiallation is happening. To install 
files wiiere you w^ant tliem, you 11 create a directory structure in 
your package that sliows how' you want files installed in the 
system, and includes a few extra items used by tlie installation 
itself. In t)rder to iim scripts, Installer defines certain events in 
the installation process and looks for scripts with names 
corresponding to those events. If the scripls exist, Installer runs 
them. 


Let s take a deeper look at setting up your files and scripts 
for installation. Please gaze directly into the magazine. 

Everything in m right place 
You II make a set of directories and files that indicates w'here 
you w^ant everything to end up after tlie installation. The basic 
pieces of the directory structure are as FolIow^s: 

• Y 0 L 1 II create a directory that contains all the other directories 
and files in tlie package, Tills directory can have any name, 
such as "PackageContents" or “Fred^ When you run 
IkickageMaker, you locate this folder. 

■ Within the all-enclosing directory, yoifll have a directory that 
hokls various files used for installaiion, such as install-time 
.st:ripLs, tlie license and readme does, and so on. Again, diis 
directory can have any name - you .specify it in 
PackageMaker, 

• A second diiedory inside the outemicxsi directoiy holds the files 
to he installed. They're arranged in direaoiies according to the 
way you want them to be in.stalied. When you run 
PackageMaker you specify' wliether you the files am be in.staljed 
anywhere or must l)e filacetl in absolute kK:alions in the system. 

Here's an example, let s say we’re going to install a package 
ihai consists of a music apiilication, ^ systein sounds, and a 
.saeeii saver module Our package directory' structure would 
look like this: 

PackageContPnrs 

Appllea Liortu 
Muislc2HyEars 
System 
Library 
Sounds 

sound!,aiff 
nound2.aiff 
souad3.airr 
Screen Savers 
ears,saver 


Scott Knaster has lx:en playing widi Apple ct>iuputers, and t>eaisionaUy working will) tlieni, since 1977. Wow. ihat’s a long tiniel SojU has written 
lx)ok.s and articles for normal hiniiaa beings as well as pnigniiiimers, Photo of Scott and bis friend JoEibee courtesy t>f John Vink Photography. 
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IN THE SOPHOS ZONE, VIRUSES NEVER INTERRUPT YOUR WORKFLOW 







Soplios Anti-Virus provides total protection against all known 
viruses on Mac OS X. Its GUI enables users to perform an 
immediate scan of any accessible file, folder and volume, while 
InterCheck technology keeps ysers safe by intercepting all file 
accesses and scanning for viruses in the background in real-time. 
In addition, every iicense includes 24x7x365 technical support 
In the Sophos Zone^ viruses don’t stand a chance* 


For a free, fully supported 
evaluatiori, visit: 
www.soph0s.com/av_mac 


SOPHOS 


www.sophos.com/av_mac 
Td 888-216-6703 


engineered for business 























Licence.rtf 
ReadHe,rtf 
prefligM 
preinstall 
poatlnatall 
postflight 

The filers in the PackageRoot directory are the software 
itself. We want the files installed in specific locations* When we 
run PackageMaker to create the package, we can make sure that 
will happen* 

The PackageRcsourccs directory is filled with files that will 
l>e used during the installation* These include the ReadMe and 
license documenis, along with several scripts (preflight, 
preinstall, etc.) that Installer will run. In this example, our text 
files are RTF, but you can also use .txt or .hrmi files. 

Staying in Control 

When the user runs Installer, usually by double-tHicking a 
,pkg file, tlie^ are the steps that take place: 

• Installer looks in the package for an [nstallationCheck script 
and mns it, if it's there. This script provides an opfK>rtunity 
to cancel the in.stallali(>n by returning a ntmzen) value* 

• If Uicre's a Welcome file (such as Welcome*rtf or 
Welcome.htnii), Installer displays It* Otherwi.se, a default 
Welcome screen appears. If there'.s a background image (a 
file named ‘'background" with extension .tiff, ,|pg, .gif, ,pdf, 
or .eps), it'*s displayed l>eliind the Weleome. 

• If there’s a ReadMe file (such as ReadMe.nf or ReadMe.hinil), 
it's displayed next. 

• Next, the License flic is displayed. 

• When the user gets to die Select a Destination *siTeen, 
Installer runs the VolumeChet k script (if it exists) for each 
mounted volume. VolumeCheck can return a nonzero value 
to prevent a volume from being eligible for installation. 

• After the user clicks Install, ihe preflight script is run. Like the 
other scTipt.s, preflight can cancel the installation by returning 
a nonzero value* 

• If the user is upgrading the package from a previems version, 
trisialler nms the preupgrade script. Otltcrw isc\ preinstall is run* 

• The package contents are copied to the destination. Actual 
installing, wow! 

• If this was an upgrade, the posiupgrade script is run 
Oijjerwise, postinstall is run* There's still time to cancel the 
installation, which happens if these scripts return nonzero* 

Installer runs the poslflight s<Tipt, if it's present. 

As you am see from these steps, you have a chana" to 
check the installation with many different scripts: 
InstallalifjnChec'k and VolumeCheck, preflight, preinstall or 
preupgradc, fx)stinstall or postupgntde, and |x>stflight. You 
should specify a shell in the first line of your script, ii*sing 
the !#A)in/sh convention. Installer provides a l)unch of 
argumeiiLs and environment variables you can use in the 
scripts. For example, the first argument ($1) ts the full path 


to the installalion package, $2 is the path to the destination, 
and $3 is the mountpoint of the destination volume* 

Pack it Up 

Once you have w^ritten the scripts you want, created the 
ReadMe and related files, and assemliled everything in the right 
directories with your installation files, it's time to make the 
[package itself. You do this by mnning PackageMaker, wliich is 
located in Developer/Applications/Utilities/. When you run 
l^ickageMaker, you see tlie k>vely screen that appears in Figure 
1. It's safe to say Jonathan Ive hasn’t gotten hold of this one yet. 

_ 


Tllli UMitiHt fKUfft 
V«^(M 


OtlHt W^rnlnti 

Figure L 7his is ihe screett that appemy when nni launch 
PcickiigeMaker. IPs not mry printy, hitt it tmrks JtLst ftne. 

To start assembling your package, fill out the fields on the 
Description tab. 'lire Title and Description fields pnwide a place 
for inftjrmaiion that's visible to users when the Installer is 
running* Click the Files lab to sjiecify the source location of the 
files to be installed. In our example aliove, this is the 
PackageRcx>t directory* Just to be macho, note that the field for 
die directory is ediial>le text, so if youYe really geeky and yoit 
hate clicking through a file dialog, you can a<lually type the 
directory path yourself* 

Next, use the Resources tab to sjiecify where the scTipts, 
ReadMe, and similar files are located* In oitr earlier example, this 
was the PackageResources tliredoty* 

The Infi) tab prtjvtdes a few interesting options. For 
example, you can chtx>se whether to recommend or reqttire a 
restart here, Restaning is mean and should he avoided wlicnevcr 
possible. (In Panther, you am also specify that logout is 
ret|uired, but you can't do it here: you have to modifj,^ the 
Info.plisi to do so. To make this happen, add an 
“IKPkgFlagRestartAaion" key with a value of "RequiredLogouC 
to the package's Info.plist.) If your software doesn't have to lx? 
installed in a particular locarion, check the lielcK^atahle box and 
users will get to pick where your software should go. The last 
Lab, Version, IcLs you Sfiecify info that appears in the Finder. 
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when you hjve your package just the %vay you want, you 
sliould save in Package Maker, then choose File -> Create 
Package to make itie package. Wlien you doiiblcH'lick tlie 
package, lastaller will launch and you'll get die excidng display 
you see in Figure 2. 

' ' _ Irvmll CifUly _ 

Wetcoint ta the Gently Weeping Installer 

Tlmiiki lor downiDJdtnQ tnli notMAre. Aibf vm imtiil li, your helf wm 
^ Introduction i ptt youKiM i^eeo, yovr compdeuori wN impiDve. ^ur tiouse rhtl 

dsan IimU, And you will MfiaiwnCd a ffwai and unoamfoHabiA iey. 

^ Sflieci D4i tlndilen I 
d InsiiifUiloii Type 

# kumtlitiQ 

• Mniili up I 


_J 

Co Reck Contiim* ^ 

Figure Z We Iristaikr ^ifmiing screen can display ensiom iex( 
and IxicL^round ima^^e, 

Tliere are a lew more fnsialler features that aren't available 
in PackageMaker- Instead, you have to edit die package's 
Info.plist file to get them. For example, when you include a 
Irackgnnjnd image in your package, In.staller stretches it out to 
fill the entire window, which is ugly if the image has the wrong 
proportions, You can gain more control over how the image is 
used by editing the lnfo,plisl file with Property List Fditor. 

Ill die package shown in Figure 2, the Tnfo.plist file has two 
new keys added to it: IFPkgFlagBackgroundScaling and 
IFPkgFlagBackgroiindAlignment, to make sure that that and 
that guy don't lake over the screen* The firsT key, which controls 
how the image is scaled, is set to “none”. You can also u,se ”tofii’' 
(the default) and "proportionar. The .second key, for alignineni, 
is set to “ixiUomlefr. Other valid alignments axe ieft'’, '*righf, 
“lop", “bottom'', \'enter" (die default), “loplcfp', “toprighr’, and 
“Ixitromright”. 

PackageMaker has a few more tricks, such as the ability to 
create metapackages, wliich are packages that contain and 
install other packages. Metapackages can present and sort 
through complex sets of dependencies for installing software. 
Another ccml feature is the ability to install packages across a 
network, which you can do if you have Apple Remote Desktop. 

iNSTAKJFRMAMA 

PackageMaker isn’t the last word in installers. U)ts of 
commercial software requires more control than you can gel 
from PackageMaker and Installer. The l>est-known non-Apple 
installer packages arc made by MindViskm Software 
(InstallerVise, ViseX, and FileStorm), and Aladdin (Stuflll 


InsiallerMaker). ITiese applications let you do things diat are 
lieyond PackageMaker, such as creating installs that work on OS 
9 or Windows, displaying multiple “tips" screens during install, 
and automaticalJy adding items to the 05 X dock* These 
pnxlucLs compete with free software from Apple, so they have 
to be fealure-packed* 

You can find ou! more, or even download whole manuals 
and applic^aiions, by visiting the web sites at www.mincfvision,com 
and www.sluffiUorn/rn3C/iristallerrrakerA MindVision downloads are 
fully functional, with limits on the installers you build until you 
buy a registration key. 'fhe In.stallerMnker download is fully 
lunctional, but pRxJuces in.slallers that say you're using an 
unregistered copy. 

Speaking of free stutT, Apple provides a pile i>f fine 
docutncniation on pat kages, PackiigeMaker, and related topics. 
For much more detail on the stuff we talked about in tlTis article, 
check OUT the following URL: 

http://developerapple.com/documentation/DeveloperTooisyCon 

ceptual/SoftwareDistribution* 

Have fun getting your installer together. Kemeinl^er, no 
matter how hard you work on your application, nolK>dy w'ili he 
able to use it unless you produce an installer, disk image, or 
other trick to gel it out inU) the world. 


9 0 0 TelnetLauncher 


Bookmark and Launch your 
Telnet and SSH sessions 
Featuring: 

>Password storage 
>Auto minimize 
>Set text font and size 
>Specify terminal colors 
>Port forwarding 
>Terminal emulation 


This and much more available from... 

piDog Software 

SimpleKeys - pi Fop - DockSwap - ScreenShot Plus 
www.pidog.com Info@pidog.com 



Kubruary 2004 • MacTech 


Ship It! DisTRiBirnNC. Your Software, Part 2 


11 














UniTAMGLINC 
THE WEB 


By Kevin llemetiway, Masticating Orifice 

Your First MySQL Data Entry 


Finally, let’s define your database tables 
and enter some data. 

in our past few issues^ we've explored installing MySQL and 
creating a database and user with mysqLsetpermission, Along 
with their access permissions and capabilities, we’ve verified that 
things had gone smoothly by using/Ubrai^/MySQUbin/mysctlshcw 
-u root -p to show the list <jf MySQL databases currently available 
(in which mactech. our in-progress database, was visible). What 
we’ve yet to do is actually define our cLuahase (what sort of data 
it'll be representing) or insert any of the data itself. 

Before we do, allow me to demonstrate another timesaving 
lip: ,my.cnf. 

Savinc; Keystrokes Wfj ii Your Persoival .myxnf 
As we’ve l)een issuing various MySQL commands, we've 
always had to be careful to pass MySQL username and password 
- certifying to MySQL that even thougli we're the OS X morbus 
user, we really want to act us the MySQL root user. Depending 
on liow confident you are with your computer's secairiiy, you 
can remove the need for the username and pa.ssword for most 
future MySQL related commands. 

To do so, open up a l>lank text document anti acid the 
following lines: 

[c Dent I 
tJser=root 

pe s r d”y 0 u t Hy SQL r o o l pa s iJwo r il 

f The following configuration definition is optional, 

II but becomes useful if you were connecting to a MySQL 
// server on an entirely different inachine. We*11 
If leave It commented here, since we'll only be 
If accessing the local MySQL Installation, 

I 

If hostnaiie^sone.other,server.com 

You'll want in save thi.s file as .mycnf in your home directory 
(/Users/niofbus/.mycnf, in my case). Be sure to include the 
Ix'ginning dot: that s required for the conllguration to be re;itl 
properly, but it will also (depending on your ,si!Uings) iitde it 
from view of the OS X Finder and prying, but unskilled, eyes. 


Since tliis new file contains the MySQL root password in 
plain text, we want to ensure that only our account c:an read the 
file. To do this from the Terminal, run ilie I'oikjwing command, 
which gives read and write permissions only to the morbus user: 
chmod 600 -/ my.cnf. Alternatively, if you can see the file in the 
linder, “Get Info"* on it, and expand “Owrters ik PemiLssions’', 
then ''Details'*. Give die "Owner" "Read ik Write" access, and the 
“Croup"' and "Others" .should have none, Y'our final results 
should look like Figure 1. 

IkMK JUl f - _, 


figure I: We access fKrmissiom uf the .myxnf file. 

With the .mycnf file in place, you should nt)w be able lo mn 
/Ubrary/MySQL/bin/mysqlshow without jequiring a username and 
password. Likewise, some oilier MySQL utilities can have other 
options preset to save keystrokes. For instantx% mysqlshow test 
will show you the defined tables of die test daialxLse: 

> mysqlshow teat 
database: tefiT 
-I- + 

I Tables I 

■h -4 

testae 

tested 

testae 

testaf 

But adding the —status flag will give you a much healthier 
dose of information ( which is so wade we can’t easily replicate it 
liere). If you find yourself issuing the —status flag a lot, you can 
save yourself Lime by adding ihul lo .mycnf under an application- 
specific bkx’k; 

fmysqlshow] 



Kevin Heraenway, coauthor of Mac OS X Hacks and Spiderirtfi Hacks, is better known as Morbus Iff, the creator of diSobeyXOfn, wliicli bills itself as 
“content for the discontented." Ihibltshcr and developer of more liunie co^jking than you could ever imagine (like the popular open-sourced aggrcgiiior 
AmpheiaOesk, the best-kept gaming secret Gamegrenf.corrt, the ever ignonible Nonsense Network, etc.), he has srarred his indexing and cataloging 
project two mcjnllis earlier tlian he intended. Coman him at nnQitys@disobey.com. 
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The basic rule is: if the MySQI. uiility accepts a d«uhle-dash 
command line flag (like —status, —username. —password, etc.). 
Mien you can define it as a preset within .my.cnf under a block 
named aficr ihe application. This c^m cKTasionally be useful, but 
I find myself using ,shell aliases fur more freciuently (which are 
outside the jurisdiction of this column.) 

DtFUSUN(i Tlil- MACTECH DATABASE 

Anytime you interact with a MySQL dalalxtse, you'll lie 
talking to it in a language called SQL, or “Structured Query 
Language”, SQL i.s an industry standard for database 
communication, and all known databases support it in some 
way (and occasionally, differently tlian what the .standard 
sugge.sts). We won’t lx* leaching you a lot of SQL in these 
colitmns, instead focusiiigon just enough to get you starrecl 1lie 
txjmpleie reference of the S(^L implementation of MySQL can lie 
ftiund at http://www.mysql.com/. 

'I'he first bit of SQL ytm'lf learn i.s how to define the 
database yotfre creating. When these SQL definitions are 
included along with otlier documentation on how you've 
approached the database dc.sign, youVe created a “database 
schema". Schema's can Ix^ immensely helpful as a reference 
while your writing code, as w-ell as when you later need to 
define a new query. 

Take a look at listing 1, which conUiins the SQL statements 
to define our macteoh database. Save this into mactech.sql—we’11 
be piping ii lo a command line utility shortly. 

listing 1: Our database definition, in SQL 

muorch.s^]! 

CHKATE TABLE person ( 

id INT AUT0_I!4CREKE!^T NOT WUT.T, PRTHAKY KEY. 

name VAKCHAR(25S}, 

date of birth DATE. 

date of^doarh HATE, 

title VARClIAfitbO) , 

dcsipaLlon VARaHAR{255) 


): 

CREATE TABLE books { 

Id INT AUT0_INCRENENT NOT NULL PRIKARY KKY, 
title TINYTEXT* 
publication DATE, 

): 

CREATE TABl^ relationships ( 
person,!d TNT MOT NULL, 
book_ld INT NOT NULL. 

INDEX (person_id,book„idj 


There are three SQL .sfatenients in listing 1, and the semi¬ 
colon that complcles them i.s retjuired for all statements you 
write, hach individual stateiiieni creates one table, being a set of 
columas that describe your data, and the rows that contain it, IF 
you know HTMI., they’re^ exactly the same as the <table> tag 
(assuming it's not used for layout). 

The first table, person, contains fields (or columns) that 
define an individual: their name, date of birth and possible 
death, title (which could lx nmks like “Maje>r”, “Pre.sicient", or 
addresses like “Sir”, “Ms”, etc.) and designation (which could be 
succession like “Jn”, “lirt "the Brave", etc.). The second tabic 
gives a rather meager definition for books, containing only their 
title and publication date. 

You'll notice dun each column is also described by what 
sort of data theyll contain. A person's name can be a variable 
length, with a maximum of 255 ciiaracters, whereas strings like 
date_of_birth, date_of_death, and publication are DATEs, funnily 
enough. A pcrstm'.s title has been limited to a maximum of 50 
characters, whereas designations could be much longer 
(as.siiming extenuating circumstances like “the Brave Sir Knight 
of Qiniclot who hxs Sleweth the Dragon of 111 Contempt!") T!iere 
are over a dozen different types of database coin mas; definitions 
of each can be found in the My SQL web docuinen!aik)n. 

Our person and books tables each contain a column called 
id. which auto increments by 1 for every new row' of data 
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entered into that table. These serv^e U> uniquely identify that 
particular record—person #15 today is going to l>e the same 
person #15 three weeks from now. As such, these columns must 
always have an integer value^ as defined by INT and NOT NULL. 
Since AUTO_INCR£MENT is seU MySQL will happily hll this data 
in for us—we’ll only need to worry about it when we’re 
selecting that record ('‘gimme person #134?”X A PRIMARY KEY, 
which is similar to the INDEX in our so-far^ignored tfiird table, 
will make these lookups of data more efficient 

Our tlnal table, relationships, contains two columns that 
represent td.s fmm our other two. This is what makes a **relational 
database” relational: lliey’re designed to relate records in one 
table willi records in another, creating a communal result Entire 
lxx>ks have lx!en written on how to smartly design databases, but 
let's go over a quick example to show how a relational database 
on ensure data integrity. Say youVe the database in Listing 2, 
wiffi a sampling of the data within shown in Lisliiig 3. 


listing 4: An example of data in a relational database. 

mactech-txt 

Table: person 

f—f-.-+-+-+ 

id I nsne | title | desi^notioji | 

—4—- ^ -^-—+ 

I [ Kevin Henenvay | Hr, | [ 

- + --+- 4 - ^-4 

Table; books 
+—+- h 

id I title I 

— + - + 

1 Mnc OS X Hacks | 

2 Spidering Hacks | 

Table: relationships 

i - —4 -+ 

person_id | book_id | 

-+- 1 



lasting 2: A non-relational database. 

non-fi^bikTm1.st|t 

CRKATK TABLE works ( 

person_naitie VAHCUAR(255). 
book^titie TINYTEXT 


Listing 3: Some sample data from our non-relatjona] 
database. 

ncin4tisnonEil,ixi 


perstJiunairie 
-+- 

Kevin Hemenway 
Kevin Remenvay 
Kevin Heoienyay 
Kevin Heaienwey 


- 4 

I book.title 

-- 4 

Mac OS X Hacks 
Spidering Hacks 
Advanced Procrastitiation 
Caffeine; Nature’s Sleeping Pill 

- 


listing 3 contains a critical “database no-mr; duplicate 
data. For every bcKjk 1 write, my name is repeated, meaning 
there are that many more chance.s for misspell tugs or similar 
errors to occur And what happens if 1 sucklenly liecome 
“Kevin Heinenway, Sr”? Suddenly, .someone has in update four 
records l>efore the correction is compieie. This updating of 
multiple reccjrds can also firing the same possibility of 
corrupted data. Likewise, duplication of data is a waste of 
space: if I write a hundred books, youVe got one hundred 
strings worth of “Kevin Hemenway”, an after-school 
chalkboard experience that’s just useless, 

A relalional database helps you store data josl once; instead 
of a hundred Hemenway's running around on the moon, youll 
only have one because you'll lx* relating a single record in the 
person’s table with a single record in the book table. Since the 
relationships are keyed toward the unique id of tiie tables, 
adding “Sr.” to my name affects only that single row of that 
person table; the linkage defined in relationships remain 
unchanged. Listing 4 shows a partial (for brevity’s sake) 
example of two of my bcK>ks Listing I’s database. 


Even though it's more tables and appears to be more 
“work", youVe st^gnegatcxl anti categorl^ted your data so that it 
stand.s alone witlitmt duplication, and related it to one another 
via the unique ids as.signed to each table. You can modify the 
data of a book without having to worn" aljoui corrupting the data 
in person, and vice versa. 

RlINNlN(i SQL CoMMAJSDS AgAINSI' YoUR DATABASE 
This is all fine ami dandy, l>ul weVe still yet to send the 
SQL commands in Listing I to the mactech database we 
created last issue. To do so, make sure you’ve got your 
mactach.sql file nearby (the following steps assume it’s 
located on your Desktop) and open a TerminaL Since weVe 
got our commands in one file, weVe going to send tliem to 
MySQL in one big butch. If you’ve not created a .my.cnf, be 
sure to add -u username -p: 

> raysql mactech < -*/Desktop/inactech.st|l 


rf there are no syntax errors in your SQL (like a missing 
comma, semi-colon, incorrect coliiinn type, etc.), then an error 
will be reponed; otherwise, MySQL will succeed silently. So 
him do you reaHy know if things went all right? jusi like we 
conftmied our database creation with mysqishow, we can pass 
the database name to get specific information, or even a table 
name to gel more (output has been iruncateci, and again, 
tjeware of your username and password if you've not set them 
in .myxnf): 

> aysqlshow m^^ctech 
Database: tnacLecb 

+- 4 

Tables | 

-■- 4 

books I 

person | 

relationships | 

-- 4 

> inysqlshow mactech books 
Database: mactech Table: baoka Kows: 0 
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I'leld I Type | Ndl! | Key | 

id I int(ll) I I PRI I 

tltlfi I Liiiytext J YES J I 

p^lbllcatlon J date \ YES \ \ 


Since weVe yci u> add any data into our duUiixiR.\ the status 
of the bcxjks table reports 0 niws. let's go ahead and add the 
data as seen in Listing 4. Open up a new text file allied mactech- 
tnsert.sql and iranscrilx’ the c'ontents of listing 5 into it. 

Listing 3 ’ Adding data to otir relalionai database. 

mack'ch mM-TLscjl 

INSERT INTO booka 

VALUES O", "Spidering HacHa"* ■'2003-11'Or): 

INSERT INTO books (publication, title) 

VALUES ('*2003 04 Or, "Hac OS X Hacks"); 

INSERT INTO books 

SET publication “ "1958-03-01". 
title ^ "Caffeine Dreanij?"; 

INSERT INTO person 

VALUES "Kevin Hemetivay". "Mr.", 

INSERT INTO relationships VALUES (1,1): 

INSERT INIY) relationships VALUES (1.21: 

UEUATK books SET publication - “2003 0301" WHERE id - V2‘: 
DELETE t'roffl books where title * "Caffeine Dreams'*: 

There are a lot of different things happening heie, so we'll 
step through each one. The first iliree statements are different 
ways of saying the same thing: ''we want to inseri this data into 
the books table." The first assumes you know, exactly and 
without fail, the order of ilie columns within your table. Tliree 
years from now, if you find yourself adding a new column 
between the id and title, this SQL stafemeiU will btxjak. You'll also 
notice that the first column, being id, is left blank: this tdls 
MySQL (as per our database definition in listing 1) to insert the 
unique ID automatically, in this case “1” (since this is the first 
rf>w weVe added). 

The second statement solves all ilie prolilcms of the first by 
specifying, in any order, which columns the data slumld go in. 
'Ilie first column corresponds to the First aigumeni to VALUES, 
the second column to the second, and .so on. Since we’re 
specifying ctjlumas by name^ we don't need to mention id at all 
as MySQL wall handle that for us. The third statement is yet 
another way of IWSERTing data, and is my currently preferred 
inetliod (see UPDATE, below). 

The fourth suitement is another INSERT, only into our 
person's table. I've left most of llie fielcLs blank, primarily so that 
it wouldn’t word-wtap on the printed page. If they were defined, 
they'd just be dales and strings, .something I'm sure alt readers 
are familiar with. 

The fifth and sbctli columns insert ID.s into our relationships 
table. Since I know that these were the first two Ixjoks entered, 
I know what IDs they’ve received: 1, and 2, respectively. Once 
we gel into interacting with MySQL with PHP and Perl (next 
article), I’ll show you how to programmatically find out whai IDs 


just-added ckita receives (which is a mut:h smarter way of doing 
things than hard-ctxling, as we do here). 

Ilie seventh statement shows how to update data yoiiVe 
already addeii. It is very similar to our third INSERT statement 
(the syntax 1 prefer) save for two ciianges: instead of INSERT, 
it's UPDATE, and we specify which rows to ujidaie with a 
WHERE clause. You'll be using WHERE's an awful lot with SQL 
as it's the primary method of selecting relevant results. Because 
the .syntax (>f UPDATE i.s very similar to the syntax of our third 
INSERT, it's easy to minimise duplicated code within any of our 
programs, 1 use the logic in Listing 6, .. with this style, if the 
columns in books ever change, 1 only worry about ttne location 
(for both INSERT or UPDATES) and not two (necessary if we 
were using differing syntaxes). 

Listing 6: Example logic to minimize code and SQL 
duplication 

psaiclocodcTor'iipdnte-inserts, txt 

$sql - 

if ($iipdatEngl t $Eql " "UPDATE books SET I 
elsJf t!$updaLiJjg) I $Bql ^ "INSERT INTO books SET ": I 

# itBsms variables are userlnput 
$aqi .= "title = , 

publication ^ *Spnh1 fcatioii * " : 

$ same assumption with $id user specified it. 
if (Supdatlng) I .= " WHERE id = ) 

The eighth and final SQL statemeol m LLsting 5 is an 
example of deleting a recrord, again determined by a WHERE 
clause, Be especially careful witli DELETE statements: once your 
ditta is geme, it's “gone" gone. 

To execute this hatch of statements, we run llie .same 
command line as before, only with our new filename: mysql 
mactech < mactech-insert.sqL As before, the command will 
succeed silently, otherwise an error will be spit to the Terminal. 
You can verify that things went smoothly by checking the 
number of rows displayed in a mysqishow statement: if there 
are two for books, two for relationships, and one for person, you 
did Imvdandy. 

Homework Malignmljni's 

Next issue, we’ll lalk about how to SELECT data from our 
database, as well as how to perform more INSERT, UPDATES, 
and DELETES within a programming language like PHP or Perl. 
If we have space, wc'II throw together a few steps on installing 
applications like plipMyAditiin and CtK'oaMySQL. Until tlien, 
contaci the teacher at morbus@disobeycom. 

Self, don't forget to put funny stuff here, 

Uhhh,.. should we leave this in? -Editor 

Kevin said hed email us. What about our deadline? 

-Layout 

He's never let us down before. Hell come through. 
-Editor 
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STARTING A 
BUSINESS 


By Cbrin Kilhoum 

Life Change Ahead 


Starling a business will change your life. How it 
will change is up to you. 


You mighf starting a l>iisinL-s.s to l^cconic i icii or to create 
a f>etter world. Maybe you want to he in control of your 
schedule instead of being at the whim of .Mime pointy-haired 
boss. Perhaps this is nor your first go-round on the 
entrepreneurial ride, and yt>u are hoping to finally achieve 
success this Lime anujnd. 

Stop fora nioineni and think aboiii what your success will 
look like. 

Are you pleasantly retia'd somewhere sunny with a drink in 
your hand while having your shoulders massiigetl? Are you 
donating the tons of cash you have earned to your favorite charities? 
Are you standing on the floor of the New York stcK’k exchange 
ringing the opening bell on your initial public sUK'k offering? Are 
you closing up shop after another great day at ilie olTice? 

No matter your goal, it should Ix^ what is driving you to start 
a business, and it should be a clear goal Beginning an cmerprise 
is a huge undertaking that will commit ami preenifX your lime 
luid energy for months * if not years. If you are still a bit hazy 
about why you waul to start a business, don't. 

in this mtmlh’s article we will examine in more detail 
ilie dreams and realities of starting and nmiiing a hiisiness, 
look al goal-setting, explore ways of integrating your 
business into your life, examine the larger hazard.s that you 
are likely to encounter as well as ex]>!ore some of the 
rewards of business ownershi[). 

Your life will change significantly after you start a 
business in ways intended and unintended. But if you know 
beforehand whai you want frtJtii your business and what it 
will want from you, the inevitable hard knocks to come will 
land only glancing blows upon you instead of sending you 
down for the count. 

MYTHS VS, REALITIES 

Mytli #1: Business owners arc rich 

Unless you ate indejjetidently wealthy, you are working in 
t)rder lo earn money to pay for living expenses - and so are llte vast 


majority of business owners. For some reason, many people seem to 
Ixrlieve that if you ow^n your own business, you tnust Ix" rich or at 
least well otf enough to only lx working at your business for 'fun.* 

1’he American Dream, and the technology industry in 
particular, perpetuate this myth by lionizing its most successful 
entrepreneurs: Jobs, Gates, Dell, McNealy. 'Hiey have earned 
their accolades. By only focusing on them, though, you lose sighi 
of the thousands cjf people struggling In their businesses day-to- 
day, propi^ed up by hope and personal credit, desperately trying 
to make that next sale to cover payroll. 

Or to pay their mortgage. 

Business ow-nership reality is that money is perfxtually tight, 
and depending upon your business, it can attach to your 
personal finances like a leeclj. 1 have yet to meet an entrepreneur 
lhat has nol been through a period f>f personal financial crisis 
due to one of their businesses. 

The harsh reality is ihal most businesses fail because they 
nin out of money and that Ixfore tliese busines.ses finally run 
out, ilie owner has pumped in many of iheir imn dollars. In no 
small numixr of cases business owners i\w forced to declare 
fiersonal bankruptcy when their businesses fold, having pledged 
ptTsonal credit guanuitees to their creditors tlial Lliey no longer 
can afibi'd to pay. 

In my own case, at one point in time I w'as juggling around 
S500,(K)0 worth of personal delvi aod credit guarantees. It made 
refinancing a car loan an extremely ijiteresting exercise once. 
This is par for the t'ourse. Be j^repared to have your personal 
credit record end up in a strange limbo lantl if you decide to self- 
11 nance your business. 

llie entreprtaieur’s drc^atii is that tliere is a huge payout 
somewdiere along the line. Hither as a .steady ca.sli cow like software 
upgrades or as a big hit like a killer piece ol hardware or the s;ile 
of the business. For tliost: of you starting your business for the big 
payday, re^ilize that ihete are tJiily twu ways to get that money: as 
cusli fitjw out of the busines.s or liy selling the company outright. 
Yi)ur busineSsS mtxlel and plan w^iil guide you us to which will lx* 
appre^priate. We will cover this in t>ur next column. 

Myth #2: Business owners have more free lime 

Business ownership: lounging by the pool with a martini 
and a cigar w^atching gardeners trim your hedges and clip your 


Chris Kilbourn is an indcpcfidcni small business, network and web infrastniciure consuliaiiL Chris is alstj the founder of tligiiitl.forest. Tne\. 
http:y/WWw.fore 5 t.net, whirii cjfters database, application and web lK>sting .services in addition to server cokKation. When he'.s nrH out running marathons, 
you may contact turn at chrrsk@foresUiet 
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grass while you try and decide lietween Jiwiticerlaiid and New 
Zealand for your next ski vnnitton. Not, 

The reality is that business owners are likely lo he working 
l6 to 18 hour days and likely have nut had a vacation in a 
while. In my own case, I did not have more than tliree 
continuous days off in five years and I worked close 70 hours 
per week fur llie first two years witli some 100 hour wrecks 
thrown in for good measure, 

Businessc's ret[uire huge investments of time, and the initial 
startup phase will require tlie iiu>st. There are lnisine,ss plans tti 
wTite, people to call, office space to secure, telejrhonc lines to 
order* staff to litre, et|uipment to sec'ure, etcetera* etcetera, 
etcetera, Then you still luive m make time lo do the work of 
your business. What you will have is more llexibility over your 
owm schedule. Unless you have business partners, there will l>e 
no one to tell you iliat you are late tt> w'ork or ihal you cannot 
take a morning off lo play hooky now and then. 

If your goal is to start a business to enable to you to have 
a ffexilde schedule w ith more frtx; time for yourself, be aware 
that it may lake several years lx,*forc your l>usines,s has growm 
enough lo allow' you to delegate projects and responsibilities to 
your staff freeing you up to do other things in your life. 

Myth #3: Business owners have no boss 

Ii is true thal when you own your owm business, there is no 
one person to tell you what to do. What gcLs short or no sliriff 
in the daydream of working for ytHirself is that each and every' 
customer of yours wall be your boss, 

lliiuk alxjLii It for a nK>mcnt, If you are airrently working for 
someone else, that [>ers^)n pnnides you with your payclieck and 
directs you in the tasks that you do. Customers also pay you, allTeil 
indirectly* and tliey can drive w'liai it is that you do on a daily basis. 

This mode of work can take st>me getting userd to. Instead 
of one person that you develop a working relationshijt with over 
time, imagine tens, hundreds, even ihf>usands of people that all 
want you to do something for them and claim a bond on your 
time. While not a codified law* 1 liave come to believe tliat there 
is an inverse pn;>poriion lo the level of customer demand versus 
the amount of money iKing exclianged! 

With a myriad of tilings to do and only a limited amoum of 
lime lo gel them done in, time and project management skills are 
critical to the success of yt)ur busine.ss. Working for someone 
else generally allows you the luxuiT of not having to worry too 
much alKiui what work you should be doing and when you 
should be doing U, If your pc:rsonal skills are rusty or lacking in 
these two areas, 1 would highly recomnieiid taking a class or 
investing in a device of .software that will help you keep track 
of the things you need lo do, and when you need to do them. 

Myth #4: RiLsiness owners are naturally successful iieople 

For tile reality check on tliis, aitend a Icx'al venture capital 
or entrepreneurial event and a.sk the other attendees about their 
past failures. Chances are, you will receive an impassioned sior)^ 
alxiut the one (or many) ventures that did not work out for 
tliem. Most businesses fati. h is jusi ihe w^ay natural selection tii 
the economic environment works. 
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Many entrepreneurs fail several times befcjre ^striking it 
rich/ even passing through l>ankniptcy several times. Stories like 
these are wliat fuel the 'rags to riches* archetype. 

Success in business is not guaranteed, even with maximum 
effort. Perseverance is key. Expeci tlial there will he laige 
setbacks. Expect that there will be some failures along the path. 
Til is does not mean you should accept a defeaiisi auiiyde - on 
the contrary ^ keep ftK:used on the goal and keep trying, for 
perseverance will eventually guide you to where you seek to Ix^, 

Myth #5: Business owners get to do exciting things 

If cleaning out the company refrigerator because the onion 
di]> went had or staying up for 72 hours straight trcuihleshtKHing 
balky technical equipment is your idea of excilenienl, you are 
going to love running a business! 

The myth is that you will Ixf out there cutting deals and 
changing the world one customer at a lime, all she time. The 
reality is rhai you will spend most your time in meetings, doing 
presentations, managing staff, sorting f)ut troubles of all stripes 
and dealing w'ith the crisis of foe hour. Oh, and cleaning ihe 
fridge, unles.s you can afford a cleaning service. 

Tliere is excitement in running your (nvn business, but just 
like everything else in life, the time in between the exciting bits 
tends to be filled with housekeeping duties and routine tasks 
that help to create a space for the excitement. 

Arf You Orfaminc;? 

One of tile mtjsi satisfying tilings alx)ut starting a business is 
working towards making a dieam come true, Ihe funny thing alxmi 
dreams are that they can crowd out obfeciive reality, hlini! you to 
peril, and isolate you in yourown happy lilllc work! to theexclusitm 
of everyone and eveiything else, Entiepreneurs immerse ihernseives 
into their dream in ualer to actualize it. If you follow this (xiih, tt is 
important to come back to the real world now and ilicn. 

S£) how do can you tell when your dream is beginning it> tip 
towards a nightmare? If things are going poorly, chances inv. that 
friends and family are already .sounding a klaxon in your face, 
attempting to gain your altemion. Ignore it at your |>ersnnal peril 

It will be up to you to do a gut-check to .see if the fears and 
concerns they have alxxit you or the busine.H,s are real or 
imagined In a perfect world, friends, tamily and lovers will 
support you with unconditional love and understantiing while 
you pursue yoiir dream. 

In Ihe real world, friends gel annoyed becau.se you really 
don’l have lime to listen to them whine alxnit their golf game 
when you have invoices to get out, family gels miffetl dial you 
mi.s.stxl a hinhclay kreause you were working an 80 hour week 
to gel a rtiajor proposal out the door and your lover t>ecomes 
enraged when they realize you have more pas.sian for your 
business than you do for them. 

Somewhere within and amongst the four worlds you all 
concurrently share, (your dream world, your reality, their tlream 
world and their reality,) there is some semblance of wlial is 
really going on, that is Ixjth good and bad, 

Everyone*s circumstances are different hut as sweeping 
general guidelines attempting a third mortgage on your hou.se to 


]:jay l)usine.ss bills is bad; trying to figure out how to invest profit 
is good; missing sunset w^alk.s with your signilicant other in order 
to compile software is bad; having lime to take a three hour 
lunch with your significant other is gotKi. 

Separating large Issues from small ones can lx: tricky dtough. 
Is your spouse’s concern alxrut money due to a real financial 
shortfall or have you just gotten ait>und to depositing a chec:k? Are 
you working too much and l>ecx>ming less effective as you go or 
are you getting all sorts of tilings done that othei's cannot see? 

In any event, communicate with those around you. That 
includes talking and listening. Kemember lhai what you are 
doing may be terrifying to even your closest loved ones and that 
their fear for you can amplify and distort small and large issues. 

I will leave it as an exercise to the reader \o triangulate their 
own situation. 

Setting Ciear and Attainablf Goai s 

OK, now^ you know that things will not k* easy and that 
you will need u> remain vigilant when it comes to avoiding 
kvoming entangled in a fantasy of how things should be with 
your l>usiness. One of the k^si ways to slay gn junded is to have 
clear and aiiainable goals. 

Ik-fore 1 founded digital.forest. 1 thought r|uite a bit about what 
1 was hoping to acctvmplish. It w^as time well spent, as it pnjvided 
me with something to strive for when things k-came dilTiaili and I 
was lerii[)ted l>y despair. I set incieiiienial gtjab that led to a larger 
goal w'hich I hojied to achieve, By attaining eatit incremental goal 
in turn, I secured acklilional conlklence to jiush forward and look 
back upon wlien it seemed like the next step was out of reach. 

As an example, one of my perstmal goals was lo have a 
more fiexible schedule. I w^anted lo be able to take time off 
when I w-anted or needed to and have other people take care of 
ihe busine.ss when I w'as not tliere. 

When 1 first staned out, 1 was a one-man show', so I knew 
that it was unrealisiic lo cxpcci ihat 1 ct>ukl \iisi take time off 
willy-nilly, as there was all sorts of vvcjrk to be done. In fact, 
there wais so much w^ork, I was regularly working more than 80 
htmrs a week For the firsi several months of ihe busine.ss. 

II jc inciemental goals I set for my.self were to nirchei dowm 
my hours over the weeks, and to take a sei amount of personal lime 
each week to do.sonieihing non-business. A.s the basmess tegan to 
gnwv ant! 1 was able lo hire my first employee, 1 was able to off¬ 
load some pager duty to her, which allowetl me .some (x>nin>l over 
my sleep ever^' other w^eek for Ihe firsi time in a couple of years. 

As the business continued to grow and there were more 
employees to delegate tasks to, I w^as able to reach a point 
where I could take a real vacation anti no\ have to worry akiut 
being called l>at:k io the office or be itiienupted by a telephone 
call. 'Fliere were the invariable setbacks when it seemerl like t 
was back to living at the office and working nt>n'Stop, but those 
pericxls became shorter and shorter as time went on. 

Ii was another year before 1 could juggle my schedule 
enough to take foe odd day off to go skiing every now- and tlicn 
in the winter. From working insane hours to being able to take 
a normal vacation and die odd day off took me six years. 
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Each step altmg the way, I knew what it was 1 was working 
towards, and I always made the next step a little harder but not 
impossible to get to from where I was at the time. 

Some of the other goals that 1 set for myself were to expand 
rny personal career skill set by learning how^ to do new things, 
have the opponunity to meet a diverse group f»f people and 
create a pn^fiiable business. 

Granted, these goals were a long way from say, curing 
cancer, but none of them were unrealistic, and 1 have the 
personal satisfaction of Itaving achieved ilieiii. 

Spend lime blinking about what person;il goals you would like 
to achieve witli your business. The f!K)re effon you put into this and 
the clearer they are, tlie easier it will Ix^ for you to aiticukiie your 
vision to others, and they can lie your personal lodestone when 
feeling u bit kxsi afK)yi liie dia.titon of your next step. 

Work to Live or Live to Work 
Adam Smiih'.s invisible economic hand may guide us to start 
a business, but the hand lias notliing to say alxiut why w-e work 
.so hard to ckjso. Keading Max Weber or Ayn Rand might piovide 
us with an insightful glimpse here and there, l>ui in the end they 
only provide us witli archetypes icj study and ponder 

Western capitalistic society Is deeply committed lu certain 
notions about work. Some of thescr beliefs are tacit and 
unspoken, others are common idioms tlial we take for granletl. 
Wheel and deal. Nose to the grindstone- Money talks, 

In many cases, how you view, approach and perform your 
work is a reflection of your culture, your upbringing and your 
values. Some cultures value family time over business time, 
while anothcT might view work as family lime. 

No matter your l>ackground in Ixliefs, be sure to ;isk 
yourself these three questions as you plunge into yt)ur business: 

• Is what you are doing meshing with and advancing ytm 
towards your goals? 

• Are you building in enough time in your schedule for 
yourself, your family and your friencLs? 

• Are you liaving fun? 

These three questions speak to self actuali7.;ition, of staying 
connected to others and to joy. Your answers to these <[uestions 
will ebb and Ilow over time. Some times they will be easy to 
answer and at otlier limes, devilishly difficult- 

If you are mnning a busiiiess and are iiaving trouble gelling 
to ‘yes' on any of these questions, it is time for you to stop, step 
back, and re-evaluate what you are doing with your time. 

Integnititig a liusiness into your life c^n sometimes lx harder 
work than getting tiie hiusiness off of the ground in the Hrsi place, 
if the busines-s Ls unduly encroaching into your life, you w^ill need 
to systematically amiove it fit>m ilie areas into whic'h it i-s ininiding. 

Setting clear Ixiunclaries |■>etweell work and personal life 
should be the first place to start. At one point in lime, I was 
carrying a pager 24 liours a day, 7 days a week and before 1 
went to bed and when I arose in the morning 1 would clieck my 
email for problems that needed lo be troubleshot- It was not a 


liealthy lime lor me, as I felt like 1 never had a spare moment 
away from the business. I w^as at 'no' for ctuc.siit)n 2 alxwe. 

I worked like that because f was still at ‘yes' on the other 
two ijueslions. Hiring staff relievetl that time pressure on me and 
allow'ed me to enjoy my work even tuone. 

Danger Ahead 

When I hit the trifecta of feeling like I was not making 
progress towards my goals, when 1 did not any liave time for 
myself, my family or my friends and w'lien I was not having any 
fun in the lousiness, I was a WTeck. 

'I'he Kail of 2000 and tlie Winter of 2(K}1 was a rougli period 
of lime for many in the Internci industry, and digital.forest was 
not iimiiLine lo the shrinking Internet bubble. It created 
cfiallenges and stresses like I had never Isefore ex|K‘rienced. 
Tliost^ pressures, coupled with a deteriorating relationship in my 
ixrsonal fife, left me unable to sleep, gave me chest pains, added 
30 jxjunds to my frame, inserted searing migraines into my head 
and turned more than a few liairs on my head premiUurely gray. 

I was a classic example of a Inirned out basket case. 

By March of 2001, my lile consisted of a haze of non-sleep 
at night and non-functioning at work, i ignoied ii:iy friends, my 
family, my hobbies, what was going on in the wwld around me. 
i was perpetually stressed about a jack of money for the 
business and the crushing w^eighl ()f debt tliai would land on my 
head if the business faileii. 

So 1 quit, i sle|)ixd down as CEO of iIr- company I had founded 
and lcx)k a four month sablxitical. A gtetit weiglu was iilled from me 
by doing so, and T felt better em{)rionaIly tli;m t luid in years. 

1 relate this tale us it neatly illustrates what can happen if 
you lose ftxus on your goals- Like many others during tlic same 
peri(»d of history, 1 allowed myself to Ix" swx^pt into the group 
hallucination tlial markets would ever expaml and that simply 
having a pulse in the Internet industry was a guarantee of riches. 

Not more than six months prior I had felt on top of the 
world. 1 had raised close to a million dollars for the company, 
business w^as booming and it seemed like the sky was the limit. 

But by taking on the dreams and goals of others, I had 
Ibrsaken my own and it left me vulnerable to the vicissiutdes of 
the marketplace and the challenges of managing a tm-siness 
tiuring a downmrn in the economy- 

Ertiof lhai the greatest threats to our businesses lay not with 
our competition, but within ourselves. 

R\kadise Aitajineu 

So what are your criteria for happiness? For satisfaction? 
For riches? 

If you know them in ytnir daily life, you will also find them 
in your business. If you seek the answ'crs to these <[uesUons 
within your business, l>e prepared for a rocky ride. 

Remember: bow your life will change is up to you, but you 
must first decide what you want to change. 

Next month: We will lighten up on the metaphysics and 
look at ihe concrete world of planning. It is gotxl for SCUBA 
diving, iiiking, and business. 
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CASTING 
YOUR .NET 


Andrew Troehen, Minnecipolis, Minnesola 

The SSCLI: Managed Languages, Samples 
and (more) Programming Utilities 


Exploring .NET development on Mac OS X 


Patching the SSCLI on Panther 

Ik'tbre wt^ dig into the meat of thts momlVs instaliment, 
allow me to adda^ss an issue regarding the prtKeSvS of l>Liilding 
the SSCU, Like mywIF, you may have purchased and installed 
Mae OS 10.3 CPanlher) on yt>ur developiuenl machines. As you 
are aware, Panther upgrades numerous core Unix Uh>Is, 
including gcc (the GNU Compiler Collection). Given these 
changes, the Shared Source CLI wWl fuHio huild tm new Panther 
machines, while upgrading an existing installation of Mac OS 
10.2 to 10.3 may cause certain SSCLI command tools to hecome 
‘funky’ (e.g,, fail to execute). 

Lucky for us, various independent patches do exist (as of 
today, no official patch from Microsoft exists, hut check the 
SSCLI weh site every now and again). The patch that I used 
to rebuild the SSCLI after installing Panther was developed by 
Dr Nigel Perry at the University of Canterbury. Now, given 
that your machine may have specific customizaiions, 1 c annot 
guarantee that the path 1 took to paicli the SSCLI will be 
identical to your own. However here are the steps that 
worked for me: 

• Download the patch (rcHor_mark2_dirfs.txt.g>:) from 
http://www.mondrian-script.org/rolor/ 

• Run the gunzip utility to extract the patcli file 
(panther_niark2_dilTs.ixL) and copy it iu /s.scii directory 

• Aj>ply the patch by changing to your /s.scli directory' and run 
the following Terminal command (Listing 1) 

Listing 1. l^JLdiing Uie SSCU ot) JVtillicr 
patch -pi <piiritlier_tt]Ejf k2_dlf fs, ext 

At this point, you can rebuild the SSCLI as described in the 
November issue. It is wonh noting that I needed to issue tlie 
\/l)uiidair command more than once to fully rebuiid the entire 


exxie base (while seletaively ignoring non-critieal build-errors), tn 
any case, hopefully these instructions will do the trick. With this 
out of the way, let’s dig deeper into the SSCLI. 

Seiegt Sampies qe riiE SSCLI 

As mentioned in a previous article, the SSCLI ships with 
various sample applinitions that iilusirate numerims aspects of 
the Cr.l (Common Language Infrastructure) and Base Class 
Libraries (BCL), the full list of which can tx" viewed by opening 
/sscli/samples/samples_rndexditmL In this installment. I’ll 
introduce you to some (but by no means all) intriguing sample 
a p pi tea t i t >n ,s, sj )ec i fi ca 11 y: 

• 11ie JScript.NKf, cLisp and myC conipiler.s 

• Codetohlml, cords and typefinder 

• Pigpad 

Understand that the goal of this issue is not to dive into all 
the gory details of tlie undcrlyiitg technologies surrounding these 
samples. Ratlier, here w e will learn alR>ui a number of samples 
that either (a) explore ihe language and [)latform agnostic 
aspects of .NET or (b) showcase useful developer tools. Rest 
assumd that the technologies used in these .sample applications 
(such as reflection and dynamic code generalion) will be 
explored al a later lime. 

Before we f^egin, recall that the /ssd i/s am pies directory 
contains a majority of the SSCLI sample code, Ytm may directly 
view, modify and compile these files at the command line using 
CSC (detailed in the December issue). Also recall the SSCLI 
sample applications are compiled w'hen you build the SSCU and 
are placed under the /sscii/buikl/v I .jipd'stchk.rotor/samples 
directory. These applications are ready to run at the Terminal (or 
xtemi) using the clix application launcher. Pick your poison, 
enable an SSCU Terminal session, and read on. 


Andrew Troelsen Ls a seasoned .NET develojxr who ha.s authc^red numen>us bcx?ks on the topic, including the awanl winning anii the .NET 
Platform. He is employed as a fuU-iime .NET Lrainer and consultani for Inrertech Training (wwwjfiterteclitrainingxom) who apologies for failing to submit 
his January article in time. You can contact (or scold) Andrew at attoelsen@mac.CQm. 
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EXPI OIUNG THF AM'|TRNATf\T. ‘MANA<;EI) LANGUACtES' 

OF THE SSCli 

In the .NET universe, the term managed language refers to 
a programming language which is ,NET aware; meaning, the 
corresponding compiler (a.k.a. a managed compiler) has hecn 
updated to understand the .NCT platform. Out of the box, the 
SSCLI ships with a total of five managed compilers ( two of w^hich 
are research-oriented in naiure): 

• The compiler (esc) 

• The raw CIL compiler (ilastn) 

• The JScript.NET compiler (jsc) 

• An experimental LISP-!>ased NET compiler (cLisp) 

• An experimental C-hased .NET compiler (myC) 

Given that the previous issue examined the basic details of 
w^orking with esc and ilasm, let’s take some time to examine ihe 
three remaining managed compilers of the S^SCLI. 

TTie dScripLINIEl' Compiler 

The JScripLNET compiler allows you to build .NET 
solutions using the syntax of the jScript (a.k.a. ECMA-script) 
language. Unlike traditional JScript however, the JScript.NET' 
compiler (jsc) Transff)rm.s The input *.js files into a true-blue .NET 
assembly rather than a simple blurb of code to be t)nx:essed by 
a scripting engine. In addition to this compelling change, 
JScript.NET also supports the following enhancements to the 
original ECMA 262 specification: 

• Support for strongly ty|->ed data 

• Full-blown objeci-nrieniaiion 

• SLI p pc)rt for lype pailitit ming via packages' 

• Complete access to the .NET base cla.ss libraries 

TheJScripl.NET compiler ilia I ships willi the SSCLI is very 
interesting in that the jsc code base (located under /.sscli/jscript) 
is aiitliored entirely in 03 Thus, given that jsc is in fact a .NET 
assembly, it must be executed via eljx. 

To view each of the options provided by the JScript.NET 
compiler, change lo the directory containing jsc 
t/sscli/build/vJ.ppcfslchk.rotor) and issue the foJkiwing 
command from an SSGLl-enaliled Teniiinal (Listing 2): 

Listing 2. Ltijjid:iutg ihu JScript.NEl’ t^inrEpikr via dix 

clix jst! 

As you can see from the resulting output, many of the 
options provided by js<' are identical to those of ('sc. For 
example, jsc supports ./output, /taigei and /reference Hags as 
well as support for response files. One feature of jsc is unique 
however, and is described in Table I, 


The interesting option of jsc Meaning in Life 


autoref This option (which is enabled by 

defauli) informs the rompilei’ to 
automatically reference external 
assemblies kised on the list of 
import staiemerTts in your Vjs code 
files. 

Using this feaiure, you are not 
required to explicitly specify 
assemblies using the /r flag (as 
you would need to do in C#). 

Table I. The inferestingjlag of the JScnpi.NET compiler 

While tins is not the place to examine each and every 
aspect of the JScript.NET progniinming language, Lifting 3 
prtn icies some sample code Lo use Lfirougliout this article: 

hsUng 3- SmipkjSLTipLfs 

// 'inip(^rC \ii y JScripi.NET spctiftc 
// keyword use to rLlereiitc! NFl’ numesipiit^eii. 

Import Sy^rem; 

//A.'iimpicdysfi lypt-. 
class Person 
I 

// Htutc d:iia of the lypc, 
private var mMame : String; 
private var fliAge ; int; 

//Type ionsiructor. 

function Person(name : String, age : int) 

[ 

this.mNaine = name; 
thls.raAge = age; 

) 

//A [vadi)nly praperty’ 
function get NaflieU : String 

I 

return thifl.itiName; 

I 

// RLMd wrilr property, 
function get AgeO : int 
I 

return llns.mAge; 

) 

function set AgetnewAge : irst) 

it {(newAge >= 0) && (newAge <= 130)) 
thiE.raAge = newAge: 
else 
I 

Console.WriLeLine(”Ug...bad value...: 

1 


// Fronjpt user for intbmuuitm ubout iliis perain. 

Console.WtiteLine(“‘ *Tlie Amazing JScript.NET App*"*] : 
Connole.Wri tet^Rnter personname: ''); 
var name : String * Console.RcadLlneC): 

Console.Write!''Enter initial age of person: "); 
var age : int = int.FarseEConsole.ReadLineO ] : 

// Now create a person using input. 

var myPerson : Person = new Peraon(na]!ie. age): 

// print name using imrinsic JScript f(x). 
print (myPerson.Natno) : 
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// IkM! ck'LH Wh^Aiy call 

Cortso Ie * Wrltfrl.inc (myPerafin. Age J: 

// Oun^' with Ap: pnjptm anti rtpriot. 
chiicky.AgG = 26; 

Console^tfriteLine^**! is nov 111 years old.”* 
my P er e on.Nane. myFe r so n.Ago); 

Console.WriteLino^“All done* See ya"); 


The first point tjf interest is the JScript,NBT ‘import' 
keyword, whicli is siniihir in funainn to the 'using' keyword 
in that it allows you to specify the name of the .NH'r namespaces 
this file is manipulating. 

Next is ilte 'class' keyword oj JScript.NET used to define a 
.NliT class type named ‘Person'. Note that type menilx^r 
variables are defined using the Var’ keyword and tlie following 
syntax (Listing 4). 

Lisiing 4. JX-finingTypc Mcnit>cr Vjriuhlev ab JScripLNET 

elass Person 
1 

// AssrssMiKltfier var NamcOfVjriablL': Ham lypcOfVariaWif; 
private var mNamc ; String: 
private vai aiAge : iiU; 

T 

Given iJiat these data points have lieen defined as private, 
we need to provide a manner in w'hich the object user can safely 
manipulate these values. Under the .NET platform, 
encapsulation services are provided (in part) by the use of type 
projK^nics. .Simply put, properties are get (accessor) and set 
(mutator) methods in disguise. Here, our Person class defines a 
read-only property termed Name and a read/write property 
natned Age. 

In JSeripl.NHT, properties are declared using the function get* 
and function set' keywords. Like a traditional accessor/muiator 
pair, properties are used to control acc'ess to state data. In the 
c^se of our read-only Name property, we are returning a c’opy of 
the private inNatiie menilxT varial>[e (listing 5). 

S.A RcjhIOhIj Praptrly JScTiiH,Nl:r 

// Ncjtc tluu prupcftici- niiMil tKf tkfinal 
// wiilj regard to tJic lypr of tbo they 
// ciKupsubic. 

function get NatneO ; String 
i 

return Lliis.aiMmne: 

The Age property is a hit more interesting in that the 
function set meliH>d performs simple data validation on the 
incoming pantmeter (listing 6), 

Lifting 6 A Rcait/Wriic i^jperty ab JScri|a.Nirr 
function set AgefnewAge : iiit) 

if (CnewAge >“ 0) ^6 CnevAge <- 130}) 

this.mAge ^ newAge; 
else 
[ 

ConsoleWriLuLlneC’Ug*. .bad value..,"): 


The major benefit of using .NET propenies, over 
aecessor/mutator metliods such as GetAgeO and SetAgeO, Ls ii»e 
fact that it simplifies die syntax for the object user. Thus, rather 
djan authoring the following Javadike axle (Lifting 7): 

Usiin); TTrjdJUtiual (ka/Set methods 

// Knt:;ip.suLiiicm usiuk accessor/mutator methtHLs. 

myPerfion.SotAge(10); 

var theAgE : iriL myFerHqii.GeiAgeO : 

We can simply write the following tlasting 8): 

listing 8. Properties in action 

// Rneapsubrion NET proprnics. 

my F e r son .Age - 30; // Triggers set ftinctiona Mry. 

var tkeAge : int “ myPerson*Age; //Triggersgvt funclioiMlity. 

Notice how' propenies provide the illusion that you are 
accessing a point of public data (whit‘h would fx? bad in.sofarthe 
that would break enaipsukilion) while .still honoring your data 
validation logic* 

The final point is the bIcK'k of freestanding* ccxle at the end 
of the tSimpleJScripi.js file. Notice that we arc blending llie use 
of the .NEl* System.Console type as well as the jScript ‘print* 
function to print our the values of the person to the Terminal 
window (listing 9) 
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listing 9. Blending BCl. t)'pes with intrinsic JSeript ftmction calls 
/y Now canitc a licrson usuig input. 

var niyPerscJn : PerBon = new FersonCnajne, age): 

// prim n:injc using intiimsk jScript fCx), 
prInt^myParson.Mame): 

// ISase d:LSS librai^* call. 

Console.WriIcLXneCmyPareon.Age): 


Compiling and Running ourJScripl.NET Application 

Assuming you have saved the previous code to a file 
named SinipleJScript.|s, you can compile this file into a .Nhl' 
code library witlt ihe command shown in Listing 10 tassure 
the infmt file is in tlie same location as jsc. If not, supply the 
full path): 

Listing U>. G>mpiliTig otir ‘.js file 

ciix jsc SimpleJScript. jfj 

You can now mn your a.ssemhly as you would expeci 

(Listing 11). 

Listing 11. Liundiuig the JStripi.MLa' ronipUc-r visi dk 

clix SitnpleJSerlpt 

Figure 1 illustrates one possible ses.'iion. 

O 0 0 _ My CpoI Terminal — icih — _ 


to 

* 

f 

u 

Figure L SImp/e/Saip/.exe at imrk. 


Dissasseiiibling Our JScripLNET-Based Assembly 

If you have been playing around with tlie programming 
ianguage, it may surprise you dial JSc:ripi.NET allo\^^s 
[programJiiers to define prograiiiming logic not contained w ilhin 
a type definition, C# (as w^ell us most other .NEl'-aware 
languages) demand ihai all programming k>gic he comained 
within a ty[>e or type iiiernbcT defijvition. In reality, the same 
constraint is found wdlh JScript.NITI’, however the awnpiler will 
take care of the details on yotir behalf. To illustrate, load your 
SiiujjlelScript.exe a.ssemhly into ildasm (listing 12). 

Lisiiiig li DisstcUtig SiinpitjSciipl viii Udasm 

ildasm SiiapleJScript 

As you look over the output, you will find that all of the 
gkihiil cxxle has Ix^en automatically placed in a method nantecl 
(surprise, surpri.se) ‘Global Code\ w hich is defined within a type 
named 'JScript O'. This class type extends 


Miero.sofLjSeripL. Global Scope, wdiich is defined within a helper 
assembly named MicrosoftJJ>cript,dll (located under the 
/sscli/l:)uild/vLppcfstchk.rotof directory). Listing 13 shows the 
CIL of the type in question (edited fordarity). 

y Sling auto^cnmicd JScriptO' Gsiss iypt 

.class public ante ansi 'JScript 0’ 
tixLends [Microsoft .JScript] 

Microsoft JScript mlobalScope 

I 

.method public instance object 
‘Global Code'O cii managed 
I. 

//All of your global code pLiced here... 

'I 

I 

In addition to the 'JScript O' type, jsc also generates a class 
named ‘JStTipi Main' that defines ihe atiplicalion's entry point: 
MainO. Ttie MainO method leverages sevenil types within the 
Microsoft.JScripi.dll assembly to execute the program. Listing 
14 hits the highliglits. 

liMing MMlic LUlaj'gcncratci] MainO method 

.cluiis public auto ans! 'JScrlpi Main' 

Gxtenda [mscorlibj System.Object 

I 

.method public static void HaintstringiJ A_0) 
cli managed 

I 

,entrypoint 

// Dt'finc a ^'iiriablc of type GlolialScopc 

.locals init (class [Microsoft.JSerJpi] 

Hictosoft.JScript.ClobalScope V_U) 

// Create the JScript O'object 

IL 001 e: iiawobj inataiice void 
■JScript 0'::-ctor(class(Microsoft.JScript] 

Microsoft.JScript.GlobalScopcO 

// Now call the 'Glob:il ClhJc() iiitthiM.1. 

IL_0023: call instance object 
‘JScript O'::'Global Code'() 

IL_0028: pop 

IL_0029: ret 

] 

I 

This wraps up our ex[iloration tjf the JScript sample 
applicatiem. If you are interested in exploring JScript.NL"!' in 
greater detail, hundred.s of articles and sample application.s can 
he found online (jusi Ik: .surc‘ to have a space between [Script 
and .NliT when searching [fScript .NLl’ noi JScript.NET]), 

The cLisp Compiler 

Tlie next .sample a[i[:ilication (cLisp) i.s a paiiial LISP compiler 
that targets the .NET platform. As mentioned. cLisp is more 
researtJi-orienmied in nature, in ihai ft does noi implemeni every 
aspect of the LISP programming language. However, the code 
base does provide an excellent foundation for those of you who 
are interested in extending cl-Lsp with new functionality. A.s well, 
if you wish to build your own managed conipilcT lliat can funenion 
within the SSCLI, cLisp is a solid example to ixiild upon. 


ncLl/biJil^l.ppcftCthi^imairl ondrtHitrKclix 

*nriijJi5g-a3crlipt,rCT 
. i.’.Lj | fwa*! riflrtiV 

Enter n iu n ol peraonE 29 


now ^ oH- 
1 See y<3 

fJkr»drew-TrwlsenMDOfcpy^9rEe»lt(^ll<i/yl4fl<:fstolf»k.ri^^ <iinidre^trA 12;3iiE40^ 
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Like the JScript.NFr compiler, the clisp compiler is 
authored in C^. ff you navigate lo the cLisp directory 
(/sscIi/sainples/compilers/clLsp), you will find all of the 
necessary source code. As well, the ciisp directory contains a 
few •,li.sp code files which can he used as input to the cLtsp 
application. For example tlie liljuJisp fiJe computes a I'ilKjnaeci 
sequence (listifig 15). 


(defun Fib (N) 

(if {<“ H 0 ) 

0 

Cif (= N i] 

I 

[Fib ( NO) (Fib { H 2)) 

) 

) 

) 


listing J ■>, fihti.Hsp 


) 

(defun Fibe (N) (do ((count D (+ count IJ) 

(Fibo (car (Fib 0)> {eons Fibo (car (Fib count))))) 
((> count H) 

Fibo))) 

(Fibo 25 ) 


Now, if you can't make heads or tails of the previtms LISP 
code, dcm'i sweat it. The [mint here is not to examine the 
syntactic details of LISP, bui rather understand how LISP source 
code can !>e used to build a valid ,NRT image. To illustrate, 
navigate to tlie /sscli/huild/vl.ppcfsrchk.rotor/sampies 
directory and compile fibo.lisp into an executable assembly 
using the following command (lasting 16). 

Ijsting Ib.Cxunpiling •iwp fijes via cUsp 

clljt clisp fibo*Usp 

The resulting .NET assembly (filKj.exe) may now lx; 
launched using clix. Figure 2 shows the program's output. 




i iw M t ; . eofsomeiri HL rttfiu I'M 


Mkr*iiU«elu rite 
fib 
rite 

P.<t t t 1 4 1 • 13 ^ UK »» tiki ITTU 2 


Figure 2 Fiixhexe at Wori. 


Much like jsc, cLLsp will auto-generate a class type and 
progra[n entry p<)int lx:lund the scenes (liiis can t>e verified by 
loading labo.exe into ildasm). While this example is enticing, 
understand that given the fact that clasp is an iiheitraWx.^ 
compiler, you do nt)i have access to the BCL types. 
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X Brief Word Kegardio}; the myC Compiler 

lii.st l)iti noi lea.si, il ifs worth pointing'out llial llie SSCLl also 
ships with another research-tjrienteci managed compiler named 
myC. ‘iTris sample exposes a (tiert') limited subset of the C 
programmin}; tanguaf’e to the .NFl' univctsc. Like cLisp, the 
sample code further illustrates the process of buildiii}; a managed 
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compiler. Sscli/sampics/compilcrs/myc/myc.html dcseritx^s the 
C# source code files used to build this managed compiler and 111 
leave ir to you to dig into the details if you so choose. 

A GAMirr of -NET Pkogramming languages 
llie .NET platform may be manipulated using numerous 
programming languages, far tx,*yond ihose ihat ship with tlie SSCLT. 
In tlie initial issue of iliis series (Octolx^r, 2(X)3) 1 listed a subset (jf 
.NFl-av^^i-e compilers. If you wish to see a more all-encompassing 
list, navigate to http://wwwl2.brinkster.corn/brianr/ianguagas.aspx. 
Here you will find links to compilers as diverse as Ada, Forili, 
Fortran, Java, LOGO (yes, I am not kidding), Mixal and Ruby as 
well as hilly hmctionally C and USP compilers. 

Keep in mind however that many of these offerings 
target production level .NET distributions such as Mono, 
Portable .NET and Microsoffs CLR, and therefore may require 
a bit of tweaking to execute under the SSCIL Tn just a few 
short issues, we will move from the research-oriented world 
of the SSCLl to a productiondevel distribution of the CLl 
named Pcirtahle .NET At that time 1 will revisit the use of 
'alternative' .NET programming languages. 

Code Documentation and ‘Type Anaitsis Samples 
Now that you have liad a cliance to check out ihe compiler- 
centric examples of the SSCLl, well examine samples of tlie 
code-formaning / assembly-investigation ilk. Each of the 
examples we will examine here are found under ihe 
/samples/utilities sulxlirectory. First up, codetolitnij.exe 

The C4>deToHtml Sample AppHcaticm 

Tlie codeLohlml sample application (which is wrilien in 
JScript,NE7) generates HTML files representing C# or JSeript.NET 
source code. To illustnUe codetohtml in action, supply the 
SimplcIScripL.js file created earlier as a command line aigumenl 
(listing 17). 

Usitrig 17. J^rocciisinf! Simp!cJSaipl,f^v 

clix codetohtini SitnpieJScrlpt.je 

Figure 3 shows the default HTML format. 

wai fa. SJffijjiWKrlp -li ' • '7 

_^ 7^ 

Source code for SimpleJScriptjs * 


The ttlkyu-Mi aikiur^anlei] JSclfit !4wm: flto urcALTulcd llii; cwKitiahtni pniKryin 



Figure 3* An HTML mew of SmpkJScriptjs 


Hie runtime behavior of codetohtml is controlled by a set 
of initialization files, whose exact names are based on the 
language of tlie input file (for example, js^codetohtml.ini for 
JScript.NET and cs_cocleiohtmLini for C#^). 'fable 2 descries the 
role of each *jni file. 


CodeTolltnil InUialkaLion FUe 

Meting in life 

<lang>_ccxlctohtml.ini 

This is the core file which specifie.s 
the names of the other three related 

'.ini files as well as the associated 
style sheet to use when generating 
the HI'ML tile. 

<1 ang>_key worIs. i ni 

Contains a list of all active keywxiRls 
for the given language. 

<limg>_fiilu rc rcst'Tvcd . ini 

Contains a list of reserved keywords 
for the given language. 

<king>_iLseixlcfined. s n i 

(Xoniains a list of iLser-defineil tyjies 
(such as class names) to l^ie im)gniif.ed 
during die fomiaiiing process. 


Table Z Tl)e iniHalizatkm files of eXHletohimi 


Of course, each of tliese Files may be modified to control 
ihe format of the resulting H'fML. Vn begin, open up 
is^codelolHiiiluni using your text editor of clioice (listing 18): 

listing iK.CoiiRnisi of js_t.<xitic>htmlJni 

de f st y1eshe e t=c od e b1ue,c s s 
keywcird5=js keywords, fni 
uBfirdcf incHi'*Jri_y.‘i£5rdc!f f rted . 1 rt i 
ftilureresei uiLjreresGrved ,ini 

ri»plac^f=Js_r4ipXuce. ini 
language=JScript 

Note that the default style sheet is named codeblue.css. This 
may be changed to the other sample style sheet, codewhite.ccs, 
by updating the defstyleslieet value. If you examine either file, 
you will find a set of .styles used to format each token category 
(keywords, code comments, user defined types and so on). 
Listing 19 shows a paitial listing. 

Listing 19. Partiiil of aKleblue.tssi 

div.code 

i 

background colorj rgb{0.0,128): 

font-family: **LiJcida Console", “coarier new", courier 

ooior: rgb(35b. 25!) ,0): 

font-size: x-entail: 

padding: lem: 

margin; l&m: 

\ 

div.code span. Liserdefined 
I 

color: rgb(bl, 51, 0): 
font-weight: bold 

To spice things up a bit, edit js_codetohtmI.mi file to 
point to the codewhite.css style sheet, Next, modify 
js_userdefinedani to recognize the System .Console type of 
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the base class libraties by adding Console ro the end of the 
ILsi. Al this pomL, run codetolUml once again specifying 
SimplcjScripLjs as tlie input file. Notice in Figure 4 that 
each occurrence of the Console type is rendered using the 
hiserciefined’ style. 



Source code forS^mpleJScrJFit.js 


jf^/^ers/iindfeiiV'rfoeisen/Weh^DtiwnlMdi/CU ^ rd- i iDcgltf 

^iiu^an hlttwii 7 



tUWiaol* *” th.* ,l3;:n Ft . Ht? AfP'-‘ 

CcCPfll* Utlt* rrjnii . ■* 

T«r nir.. Itjiaf Comal* fiaaditr 
CtHifeAl* ^trixi.f ir-SruJ. i-f* -r |n* r' ■ 

VAlt :t> iat l«t l■4rlt^ COAial# mjULiA# 


v«r 1, 


f#*!™ p*ai , TJ* 


c 


prir.T !ivP"r»3n S?4 ei* 

-CaniDta MfII*.!.!!. Afi Aa- 


Figtire 4 Cmtom code to / ilML/onjialting 


clix), you will see a list of all available options. Table 3 
documents a partial listing. 


Interesting Options of Corefe 

Meaning in Life 

-w 

Generates output in HTML format. 

- ill namtO/Assem hl y ‘1 bSea rch 

By dcfauli, ctirds only sea relics a 
core .NET BCl assembly named 
mscorlib.dll. If you wish to browse 
other assemblies (induding your 
custom assembles), use rhe-m flag. 

-noinherit 

PrevenLs the dis]:)lay of mlierited 
methods and tlelds. 

-V 

Displays only output visible 
(pLihlic and protected) classes, 
metliods, or fields. 

-P 

Displays only output public classes, 
methods, or fields. 


Tahie J, VariousJJags of corcls 


Beyond creating custom style sheets for use by codetohtml, 
you will also want to check out the JScript.NET source co<le for 
this example (codeLolitml.js) as it illustrates a numixfr of 
interesting .NET liase class library types. As you already know 
how to interact with the JScript.NHT compiler, teel free to hack 
away U) your heart's eontenL 

The cords and typefinder Sample Applications 

Cords and typefinder are e.sscntially object l>rowsing 
utilities (wriuen in C^) that i>rovide a lightweight alternative to 
ildasm. The cords utility can be helpful when you simply wish 
to view the definition of a given type^ rather lhan the 
underlying Cll code. If you run cords at the command line ( via 


Again, by defaull, cords only .searches the core .NET 
assembly, mscorlib.dll. If you wish to view definitions hir tyfies 
defmed in other assetiiblies, you will need to specify the -nV 
option, By way of a few' examples, lasting 20 will display type 
!nh>niiation for SystenuString, Listing 21 displays the same type 
as HTML (via the '-w' option) and listing 22 duiiijis information 
alx>ut tlie J\^rson type defined within SimpleJScript.exe (origlnaliy 
defined in JScripr.NET). Be aware that w'hen you run load exlernal 
nuxlules with the '-ni' option, you will need to ensure a copy of 
the huvAty file is in the same directory as cords itself. 

f 20 ,Viewing Systitm.String 

ciiK eorcis System.String 


RE AI.basic 


AppleScript 


Director 


Java 


C++ 


XCMD 


SuperCard 



MetaCard 


WebSiphon 
futureBASlC VisuaiBasic 


Valentina 

Object-Relational SQL Oatahase 


The fastest database engine 
for MacOSAVindows 

It operates lOO's and sometimes 
a 1000 times faster than other systems 

www.paradigmasoft.com 

Hosted by macservemet 
Download full featured evatuation version 
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Aria'e/treme 




Add Airport Extreme to any G3 or 
G4 PowerBook! Get blazing speeds 
up to 54 Mbps (five times AirPort Speed!), 
comes with an external stub antenna for 
better range than internal cards! 

(requires Mac OS X 10.2.6 or above) 


OTC Wireless 



802.11g Ahernet Adapter \ 


Driverless Ethernet to 802.11g 
converter. Simply plug into the 
Ethernet port of any Macintosh, 
PC, or even printer to put it 
transparently on your 802.11g 
(54 Mbps) network! Use with a 
hub to enable multiple devices 
with one adapter! 




> .At 


mxj 

















































Easy to install! Step up to 
AirPort Extreme (54 Mbps) 
for any PCI Macintosh! 

(requires Mac OS X 10.2.6 or above) 


AirPort Extreme 
(802.11g) PCI Card 



Want more range from your AirPort 
Extreme base station? This 5 decibel 
antenna is 30% more powerful than 
other brands! 




Belkin Wifeless 
Cable/B$L Gateway 
Router 

















cllx cords w System.String 


Lbting 21 . Sysirm.^tiing as HTML 


Listing 22 . Viewing Person 

clix cords -nt SimpleJScripl-exe Person 


5 shows the resLill of executing listing 22. 


^ My Cool Terminal — icsh — 61x34 


Persoi 

:rott JhaduLe 'A<3$r9^r^aidreHftro«l£0n/'^_doHnLeod£/clt/ssctlf^ijl Idyvi.ppofttdih . 
rolar/icwifjles/utl 11 tlfta/corc-lass/stip Lejscript.exe' 
piUbtlic ctdSS Pensjn ; 
ot>ject, 
tNcBdEn^tne 

i 

// Fields 

pflvott int sAOd: 

prtvote ftftftO iKWdffl^; 

jar 1 vote VuCngine vsn tngine; 

// Gionutructor# 

private .cctorOl 

pObllc .ctor<3ti'tngi none, int oge); 

// Propeniei 

pUaUc Int ^ { virtual get; virtual »t; y 
puoHc tiring Nom { virtual get; } 

// rteunjos 

privotfi vdtd *lnitc>t 

*w&uc overritJe bool lquq|s<objeot obj>; 

protected eveirlde void finoItJeO* 

private virtual VsaCingine GetEEiglne(); 

public override int oetH3sh€CN»(); 

pubhi; Type CetTypeO; 

protected object MefitoerylseCiorie<>; 

private vlrt^l void SetEogine^VesEnglne ); 

public override etring To$trmg(); 

} // e«Kl of Person 

[Aaidreu-TFoel^ns-^ceputeriswoleeAitUltlefi/corclOEe} ondrevtrX _ 10;£6;£2pH 


Figure S’. Vietpinji Person in ihe syntax of 

The funetionality of typeftnder is simihir lo thin of cords, 
however this kkiI allows you to gel mudi more sjx-dfic. Using 
a set of display opiions, you can view various aspetls of a type 
such as the set of interfaces it supports, the meihods it contains 
and so forth. IT allow ycni lo explore the full set of options via 
the findiype.lnml file located under 
/ssdi/siiniples/utilitie.s/typefinder, however to prime I fie pump. 
Table 4 lists some possihilities. 


Typefinder Option 

Me;inuig in life 

-tl: NameOIOiretior)' 

Used to .specify a dirca<ir>^ wliidi conuiins 
the assembly you wish lo invesiigaie. 

-X 

Used to siTedfy the fully qualified name of 
the type in a given assembly. 

-a 

Shows ail information for a given tyfx^ 
including inlieriietl memlx?rs (very helpful). 

-f, -i, -in, -p 

Shows the events, fields, interface*s, mctluxis 
or properiies of a given type. 'Hiese Hags 
may be combined into a single crmimend. 

-r 

include ba.se clas.s information. 


Table 4. Select options o/typcfmtkr 


As an example, the command shown in Listing 23 yields 
the output seen in listing 24. 

Lnaing 23. Working with t)pcfinder 

dix typefinder -xlp Syf^tnm.Sttinf^ 

Listing 24, Viewing the properties and inierfiictfs of die S)'stcm. String type 

das^ System.String 

If Interfaces; 4 

interface System. I Coatparable 
interface System.ICloneable 
i nterface System*IConvertible 
interface System.Collections.lEnumerable 
Properties 

Char Chars llnt32] 'get' 

Int32 Length ‘get’ 

When working w'ith typefinder^ be sure to clicck out the 
role of the -d* option (as ii will prt>vc helpful when you wish to 
view types in external assemblies, such as SimpleJScript.exe). 

This Lrmj: GUI is Platform iNoiiPtNOENT 
To wrap up tltis insiallment, we will examine what could 
be the most inciting set of sample applications, the Platform 
independent GUI CPIGUI). A.s meniioned caHier in this 
series, the SSCLl dtTcs not ship with an implementation of 
System. Windows.Forms (,Nld'\s native GUI toolkit). 

However, to illustrate wliai can be done wiili the CLI, we are 
prfwided with a set of sanifiles that leverage the tcl/tk 
libraries, repi'esented on the Macintosh by two *,dylib files 
{libtd8.4Alylib and libtk8.4,dylib). As a friendly reminder, 
recall that the process of installing lel/lk was de.scribed in the 
November installment. 

The SSCLl offers a handful of samples that leverage the 
tcl/ik libraries: 

• flello: A simple application iilustrating GUI event handling 

• PigPad: A text editor appik'ation 

• Tk: This sample builds the required assembly 
(sharedsourcecli.tk.dll) that wraps a subset of the tcl/tk 
libraries 

Tlie Tk ,sam[>le code is very illumining lor a few reasoas. 
First, the code base illustrates how ihe .NET platform can 
communicaie with the AfU of the underlying operating system 
(as well as native libraries) using a specific attnbute nametl 
DllImportAttribute {attributes enable aspect-oriented 
programming lAOPl techniques under .NiH', the full details of 
which wall Ix^ descrilxrd at a later time)* 

On a more practical level, the as,sembly generaied by die Tk 
sample (sharecLsourcecIlik.dll) is rc-tjuired by all other PIGUI 
examples. Given this, you must ensure that a copy of 
sliarcdsourcecli.lk.dll is placed within the same directory as the 
executing assembly. F'uffherm<>re, you will most likely want to 
copy the tcl/ik libraries are in the same directory of the pigui 
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sample* application you wish to am. If you installed tcl/tk using 
Fink Commander, they sliould be under /sw/lib* 

Enabling an Xll Session 

To execule llie FlGUl sample applications, you must 
initialize Xll (full screen or rootless), and run these SSCLl 
samples from an xterm session (as the Macintosh Terminal 
applet does ncii iniiialize the necessary Xll varmbles). Now, 
when you Install Fanilier, you liave the option to install X1 
which it may be kumched using the Xll applet located under 
the Applicaiions/lltiliries tiirecrory. 

If you are not running Panther, you must obtain Xll 
from cyberspace. While there are numerous distribuLions of’ 
Xll for the Mac, I'd suggest you download and install 
Apple's office XII implementation (consult 
http://www,applexom for further details). For the rematnder of 
tliis article, I will assume you are at least somewhat 
comfortairle manipulating Xll. 

Playing with the PlGllls 

by default, Apple's XI1 distribution makes use of the 
(Quartz windows manager (quariz-wm), which can be verified by 
investigating your machine’s .xirdtre file. Assuming you have 
activated Xll, enable the SXCkI from an xterm window (via 
DoSscli) and navigate to the pigpad sample applicatiem located 
under the /ssc'li/buikl/v 1,ppcfstchkjotor/samj>tes/[Mgui/pigt)ad 
directory. Finally, exec'Ute pigpad via clix. Figure 6 shows 
PlGUl running under the default Quartz windows manager, 

^^0 0 C# Notepad Using TCL - Untitied 



Figure 6. PigPad under ibe Qtiariz Wmdow Managi^ 

If you edit your .xinitre file to load an alternative window 
manager (which may be obtained via Fink Commander) you 
would find that pigpad takes on an entirely different look and 
fed. To prove the point, update .xinirre to load your window 
manager of choice (Listing 24 illusiraies the loading of 
Window Maker), 


listing 21 Lci^iding Window Maker as die Xll Windows Manager 

jl Tlie Apple UH, 

4 qyartz-wm 

# Window Maker 
exec /ew/bin/vmaker 


Once you have updated and saved ,xinitrc, close down 
and then restart Xll. Now follow the previous steps to 
execute the pigpad sample application. Figure 7 shows the 
new look and feel. 



Figure Z HgFad under Window Maker 


Very cool! If you are interested in digging into the 
^who, what, where and why” of how pigui does ii\s magic, 
your first step is to examine the documentation of the Tk 
wrapper (/sscii/samplcs/pigui/lk/lk^w'rapper.htmi). Once 
you have a general sense of the exposed functionality, you 
should be able to alter the code base of pigpad (or pighello) 
to your liking. 


Wrap Up 

This instalfmenl rounded out your understanding of the 
SSCLl by showcasing a numljcr ctf ,sample applicaiions and 
managed languages. We began by exploring theJScnpt.NET 
programming language and learned how jsc can be used to 
build .NET assemblies using a scripting like syntax. We also 
took a very brief look at the cLisp and myC compilers, and 
examined a set of sample applications that allow you to 
explore the format of a given assembly in a more lightweight 
manner than ildasm. Finally, you had a chance to see how 
Lcl/tk was ii.sed to build a platform independent GUI under 
the SSCLL 

The next issue marks a conceptual shift in this series. 
Wtiilc these first issues concentrated on the overall nature of 
the .NET piatfonn and die role of the SSCLfi the next several 
anicles will pound of the syntax and semantics of C#, and 
see how this programming language expresses the type 
system (classes, interfaces, structures, enumerations and 
delegates) of .NET 
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MICRO¬ 

CONTROLLER 

PROGRAMMING 


By Tom Djajadiningmt, Designed Intelligence Group, H.irtdhoven Unii’ersity of Technology 


PIC Microcontroller Programming on 
MacOSX 


Using a VOTI Wisp628 with JAL 
and XWisp 


ABsntAcr 

Tins article exj^lains how to program a Microchip PIC 
niimK’oniroller on a Macintosh mnning OSX. Tlic pn>gnminTur 
liiirclwarc thai Ls ijseti is a Wisp628 l>y Van Ooijen Tcchnische 
lnfornia!i<'u. 'I'he software consists of two parts. JAL and XWisp. 
JAL is an o|K'n s^>urcc, high-level language lhal is tised to 
generate a PIC compatible hex file. XWLsp is Python-based, Ofien 
source software? that is used to upload the hex file from the 
Madniosh htisi via the Wis|Xi28 programmer board to the PIC 
iiiicrocontroller. The article explains how to compile JAL for 
MacOSX, how' to crt'ale a txmnection from the Mac via the 
Wisp628 prograiiinier iKjaid to the target circuit containing the 
PIC, Ikjw to uplouil a hex file using XWisp, and how^ to cTe^ite a 
simple LPD flashing prognim. 

iNTRODlfCnON 

Software ft>r elecironic engineering piirpo.se.s hiLs Ijcen far 
from a strtinghoki ft>r the MacinlosiL ExjKxaally aflbrdubie* 
electronic hobbyist level software that is compatible with a Mac 
has traditionally been huai to find, l.ucktly, W'iih the arrival of 
OSX I his has changed somewhat* Due to OSX’s UNIX 
under|)innings it is possible to recompile many opMjn s<nirce 
software jxickages to run on a Mac, 

In this ankle we show how lo use two pieces of opm 
source .soflware for microcontjoller programming on an OSX 
Mae. One we will recompile using the GCC compiler, the other 
we can run using Pyahon. Both the GCC compiler and Python 
are standard coniponenis of the Apple Developer IVkjIs tor 
OSX. Don't worry if you have never done any of this Ix^fore: this 
article Ls meant as an absolute beginner’s guide. We’ll lake it 
nice and slowly, guiding you through the whole prtxess, one 
step ai a lime. 


Required hardware and software 
’Ihis is what you need ui gel PIC j)rogratiiming on a Mac. 

Hardware 

• Macintosh running OSX.2 or OSX.3 

• a lISB-serial adapter 7‘here are several types on the marker. 
We tested twx>: 

• Keyspan USB High Si>ccd Serial Adapter USA-19QW 
(Figure X) 

costs: approx. 4(>'S0 1 ISl) 

I nfo; W WW, keyspa n. co m 

* GMnS-03 USB Serial Adapter (Figure 2) 
costs: ai>prt>x. 22 USD 

available frojn; w\w.v<aiml 

• XWisp 628 prognimmcr Ixxird (Figure 3) 
available from: WWW.VOti.nL 

co.sts: assembled approx. 33 USD. As a kii: approx. 24 USD. 

• DB9 straight-llmf male-female serial cal>le (if your physical 
worksfiace is close to your I’SB port you may lie able ro do 
witlioui it and connect your USB-sedal adapier siraight to the 
XWisp 628 prognimmer lK>arcl) 

• Microchip PItM6f877 niicrocontroller or its slightly cheaper 
successtjr, the PiC-16l877A, These are popular PlCs with 
high specs. 

available from: mexst electronics stores, including WWW.VOti.fll, 
costs: approx. 10 USD for the ]6f877 or 8.30 I.ISD for the 
l6f877A 

• HI ed ro n ics I) read! x )ard 

available from: most electronics stores, including www.voti.nl 
costs: from approx. 11 USD 


Rtxenlly, Tom's wife gave liim a brand-new, 3,5kg, non-Apple laptop. Admiringly, he now uses his Ti-BfM>k much less a.s his new laptop is in every 
way more inieiligent and fim and appt:ars to IxHOine even more so by the day* Its only disadvantage may be dun it also go-iws even heavier every 
day* You can flame him on his Apple Lnfideiity at j.p.djajadiningrat@tlte.nl 
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WWW powerglot com 


/K 


Fillin' 1: Ki/ysfmrt USB Hi^h Senai Adaptct^ USA-I9QW 


Figun* 2: €MUS 03 (^SB-serial cidapUr 


Figure 3: The XWisp 628programmer h^mrci hy V077. 77}e kfi- 
hand side is connected to the USB-serial Adapter through a 
straighi-tbru DB9 ^nale-feniale serial cubie, the right-hand side 
accepts a DB15 connector leading to the target circuit. 


SOFTWARE 


LOCALIZATION 


MAOE 


easy 


POWERGLOT FEATURE HIGHLIGHTS 

Localize Classic, Carson , Cocoa' ano Palh OS affs 
Leverage existing translations 
Automate wttm AffleScript® 

t«FORT /EJ^FORT TRAKSLAtjOH MEHORIES 






Mac os. Carbon, Coeoa ApfrfoSorlfitoro traAomavtu of Compotor, lft«> 
Pffim taS I* ■ tnHfbmorfc of N»c. 
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Software 

• Apple Developer T<x)ls 

for MacOSX.2: Deceml>er 2002 Developer T<k)Is + 

2003 gee LJpdaier 

for MacOSX.3: Xcode Tools vLl 

free download from: http://developer.applexom/tools/download 

• Keyspan drivers. 

Make sure tliat you have a version that is compatible with 
your version of OSX. 

free download from: http://vwwv.keyspanxom/downloads/rnac(3Sx/ 

• JAL, latest distril)uiiori. We used 0.4.59, 

free download from: https ://soureef orge.net/projects/jal/ 

• XWisp 

free downltjad from: http://www.voti.nl/xwi5p/xwisp_src.tacgz 

'llie total costs add tip to arotmd 77*105 USD exeluding 
shipping and handling, depending im your choices. As you may 
have ntned, the GMlJS-03 USB-serial adapter is considenibly 
cheajxfr than the Keyspan. GMUS4>3 Drivers tor every flavour of 
OSX ant' available and the thing works admirably for what we 
are doing in this article. However, whilst Keyspan have certified 
their adapter with a great many serial devices, with ihe GMl IS¬ 
OS your mileage may vary. 

You can save some costs by buying the WLSP628 
programmer in kit-fcjmT, rather than ready-assembled, and by 
going for a chea|>er model PIC, 

Jal 

We tackle JAL in three parts. Firstly, we prepare JAL for OSX 
by making a minor change to the ccxle, then we rexxJinptle JAL, 
and, finally, we try out our newly crerated JAL executable. 

Preparing JAI/s source code for OSX 

Assurning that you have downloaded all the required 
s<jftwarc ctjinponcnts, we start with compiling JAL for Mac OSX. 
‘lb do this you have ttj work with Terminal. In the Finder, slari 
up Terminal which is located in die folder /Applications/Utilities. 
Now we have to navigate to the JAL folder. 1 dnjpped mine in 
Applications. The easiest way to change directory in Terminal is 
to type cd, fill lowed l)y a space, and then drag the folder you 
want U> navigate to from tlie Finder onto the Terminal window. 
Terniinal will then add the correct, absolute path. In my case, the 
Terminal window says: 

a-P'DjajfldiningraU-ComputerTomSed /Applications/ja i- 
0.4.59 

In your case, Tenninal may say st^mething tiifFerent, 
depending on the version of the JAL distribution and on where 
you put it, 'I’ype ENTER to change to this diretlory. 

From now on, we use a dtjliar sign to rcf^resent die 
Tenninal prompt. For all clarity, you only need to type what 
follows the dollar sign, not the dolLir sign itself. Alst>, this was 
the first and Iasi lime we menLk>ned that you need to type 
ENTER after eacli Tenninal command. 


Do a listing of the fa 1-0.1,59 directory by ty(3mg: 

$ls F 


This .should give you tlie contents of the JAL directory as 
shown in the screenshot in Figure 4, 'Hie openind -F makes that 
the listing displays directories followetl by a slash (V) and 
executables by an asieri.sk ('*'). 


0 0 0 Tennmal -*■ bash — B0x2S ., 

Last iogini Frl itov se W:i2!54 on tt^pi 
Velcone to DarMin^ 

J4>--01ajQtfinir^aU-C<x^>uteT:-' Tan* ad /A|ipllc€itt(Nna/jDt-«,4J59 
a-f>-DioJai:liniitigirats-Coeiputer:/A|]ipl tcotloiis/>ai-d.^.S^ TodI ts -C 
M1THQR3 NEWS ponf^g.log nykirutalldirs* 

COPVIkC oorif tg.statuf* jal.asp* 

ChongeLog RPiOrE unrig.sub* jal.h** 5tix«P-Nl 

INSTALL TOGO ponf igure* jal .spac VBmion.h 

HAINTAIIERS OClOCOl JlH COflf iguTv.dC Jdl .3i)vc.tri 

NidiccttLc mrrf ig.ijJHS* depcoap* >al .vepraj* 

rhMeftie.oA config.h t>K/ Hbv' m 

iLe.ln contig.ti.in Instal ainlngi* 

J4'-0]Qjadtniriorats-Coapi4ter:/Ap^tlcattorKS/jal..e,4,59 Toii* | 


I 

I'r 

figure 4: Navi^atifi^ lo ami //.sY/ug ibe jaf-0.4.59folder 


Within the Jal-0,4,59 Ibkier, we now^ navigate io the source 
code directory which Ls .simply called jak 

Sed Jfil 


To see a ii.sting of the source ctrde in the jal direciory you 
can again ty|X': 

Sis -F 


Before we ran sian compiling we have to make a small 
change to the file sidhdr.h (note that if yt>u liave a newer release 
than 0.4.59, this change may not lie necessary anymore). Type: 

$<3pen stdhdr.h 


Depending on what version the Apple f>evcloper Tools 
you are using, stdhdr.h opens in either Project Builder or Xccxle. 
hxik for the piece of ccxJe in Listing la. 


Listing la: stdhdrh _ 

*irikfHAV£„MAlltX: u 

#ifdef HAVE_HALLtK;_a 
jfinciude <mailoc.h> 
jalfte 

Vdid *nialloc (int); 

#endir 

Comment out these lines, C style, by adding slash-asterisk 
(■/*9 in front and asterisk-slash Ixhind (**/') so diat the bkxk of 
code l(K)ks like Listing lb. 
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listing lb: stdhdr.li 
/* 

jfifdef FrAVE_MATJ.OC_H 
tfliiclutie <ii]€illoc.h> 

void ^malioc(int); 
tfendif 
*/ 


#iftkfMVE milOC 1] 


Don't worry too much atout why you need to make these 
changes. Basically, on OSX we already get access to malloc hy 
inciiKling sldlibJi, and therefore including malkjc.h gives 
‘already defined’ errors. Close the file Ln ProjectBuilderOCcode 
and save your changes. Now we are ready to stall compiling. 

Compiling JAL 

Switcli back to lenniniil and change to the directory jal-0,4.59 
which means we have to go one directory level upwards. Type: 


Listing 3: $sitdo make uistall 

Rt^iiponst to Ssudo myke msQlJ 

/bin/sh . Jmkinstalldiri; /usr/local/bin 

/osr/bin/tn.'stal 1 c jal /nsr/local/b In/jal 
laakoil]: fJuthlng to be done for 'Install d£iiLa-atn^ * 


As you am see, the JAL executable ends up in the directory 
/usr/local/bin. To convince ourselves, change to Uie installation 
directoiy and do a listing: 

$cd /usr/local/bin 
$ls -F 

And there you have it: jal followed by an asterisk, indicating 
that this is an exet uiable. But there is more to the jal insfallation 
tlian just the execLitable. Tiiere are also several include files. Let’s 
see whether we can llnd them. 

Change to the parent directoiy^ /usr/local and rto a listing: 


$cd 


$cd *. 
$ 1 s E 


The next stej? is to configure compilation for your Mac l)y 
laimcliing the UNIX executable configure: 


In it you sex^ a directory named share. Change to it and do 
a listing: 




$cd 
is -F 


Running it takes a little while, during which you see a 
whole bunch of checks rolling hy. Finally, Terminal should print 
the message in lisling 2: 


Listing 2: $yeonligure 

j£il-Ci.4*59 is now ooiiflgurod for 


Closing remjirks during oompibition 


Build: 

Host: 

Source directory: 
Installation prefix: 
C cowpjlcr: 


powerpe^appi^-darvin/.0.0 

powerpe’apple■darwia?.0.0 

/usr/local 
get -g -0? 


Now type: 


rhere you find a directory called jal. Change to it and do 
a listing: 


$cd: jal 
$lB -F 

Finally, Uiere is the lib directory. In tliis directory you find a 
couple of do 2 en of include files: 

lib 
$ls -F 

1 hope this gives you a feel for where your Jal installation 
ends up. 


$make 

This takes longer, as gcc compiles JAL. To complete the 
installation process type: 

^sudo make Install 

Note the sudo (superuser do) command. It allows an 
adininLstrator—wiiich [)rcsumabiy you arc wlien you arc on your 
own Mac—to run commands as superuser. Basically, tecoming 
superuser upgrades your priviliges so that you may access Hle.s 
and directories which normally arc protected against (accidental) 
misuse. In iliis case, we want to install into the /usi/local/bin 
directory which is a protected directory. After entering this 
ctjininand, Terminal tlicrelbrc asks you for your password. Once 
you have given it, Terminal res^xinds as per Listing 3- 


Taking JAL for a spin 

Cn.‘ale a directory somewhere convenient for your JAL 
source files. Mine is called sre and lives on a partition called 
Data. Now we create a JAL source file. First, using a text editor 
of your choosing (I used XCotle), CTeate a new empty file and 
type in tile code in Listing 4, Don’t worry about the exact 
meaning of the code for the moment. If you are curious, later on 
we will use this JAL progntm to flash an LED connected to pin 
aO of our PIC: 

Listing 4: ledMa.sh.j^ _ 

The full lcdfla.^h.pl source file 

include I6fB//_20 

include jlib 

disable_a_d_functions 

pin aO direction = output 

forever loop 
plii_aO = high 
delay_l0inS [2S5) 
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piii_aO - low 
delay _10nS (50) 
end loop 


Save the file into your source file directory under the name 
leclfiash.jaL 'Hie filename itself is up to you, bur it is tTitit'ul that 
you use the .jal extension. 

Change to yi)ur source file directory by typing cd, followed 
by a space and then dogging the direaory from the Finder onto 
your Terminal window: 

$cd /Voluinas/Datayerc 


Do a sanity check verifying Uiai the file ledfiash-jal is 
actually in there: 

$ia 


And now, for the moment supreme. s try compiling 
ledflash.jal using our jal executable! 

$/Msr/lDcal/bln/j 3 l ledflash.jal 


As ledfiasli.jal is com[)ilcd. you sue tlie lines fiasli by and, 
finally, Tenninal responds as in Listing 5: 


Listing 5: $/itsr/locaI/bm/jal Ledflash.jai 

JAI, t‘ompilini» ktlflxsh.jiil 

Jal 0.4.59 (GCC 3.3) 

input files: 12 lines; ;i244 chars:53707 (2952 

lines/second) 

compilation n&d€S:12&95 stack;53Kb hoap:3928Kb seconds;0.760 
output codeitOl stack:2 

OK 


Have a Icx^k w^hai is in our sre directory now; 
Sis 


There you liave it: in addition to a .jal Ole, tliere are now an 
assembler file (ledflash.asm) and a hex file (iedfiash.liex). Drag 
them OHIO your favourite text editor U> see their conient: 

The hex file i.s very compact as shown in Listing 6. 

Listing fi: ludfla.sh.hex 

The ledfbish.ht^ file resiilting fnim ccimpiling k'iina«li.jai with JAJ, 
;020000040000FA 
;020000000428D2 
:Oe000800FF30A100FF30A2004F 
:10C01000FF30A300FF30A4000F3aASG08AnOAl2AO 
:106020004120211OBAl]OAJ25C202614SA1lOAJ20D 
:100030005620FF308A1IOAl22Ba026108AllOA122C 
;IO004O005620323D8Ail0AI22R208An!>Ai21528E2 
:I0005000aA110A122828A;002/08A8aOb430A9000E 
:100D6000G130BA110A123428AAOOFF30AB00290897 
:H)007000AD002808AC0077308A110A122B0703184C 
:lOOOgOOO 3 E 28 SAllOA 12 ACOB 3 B 2 eaAI 10 A 12 ADOBCA 
;lO009000392&8AilOAl2AA0B3728Q8Ofl8AllOAl275 
Im0DA000fi220073O9F00BAl10A1265283A110A12FB 
; lOO0BO005928260S85000800BAn0Al25F2821O89D 
:1000C0006500080083160313080083120313080059 
;02400E00723FFF 
;0000000IFF 


1'he assembler file is something you are supposed to never 
need. The gurus use it to debug the compiler and to learn ht>w 
assembler works, te. to figure out wlial tlie PIC really dtx:s for 
A = B + C. 

So far so good. We can write a simple .jal file and compile 
it using an OSX native JAL exccuiablu, resulting in a hex file 
suitable for a PIC microcontroller. Now how do we actually 
upload this hex file from the Mac to the PIC? 

Uploading the hex tile 

First, we need to get our physical, serkil connection 
lietween the Mac, the Wisp628 and ihe PIC mkrocontroller in 
order, then wu look into how to use the XWisp software to 
upload our hex file to the PIC. 

Serial connection 

Plug your USB adapter into the USB jxjh of your Mac. 
As,suming that you are using a Keyspan, you can do a check by 
Rinning the Key.span Serial Assistant whicli live.s in your 
Applications folder. Tlie Serial Assistant should recognise the 
adapter (Figure 5). 

© 0 0 Keyspan Serial Assistant ^ 


_ Serial Ports 

Y ^ 1 IUSA19W1 

[USA19QW181Ph] 

A 

/'injure 5: Tbi* Kt^y^mn Serial Asstslanl 
ackriowleciges the mkfpter 

Depending on the cable length you need iMwcun your 
U.SB port and your physical workspace, you can connuen the 
W[sp628 1x)ard directly to the USB adapter or connect it using a 
'stniighHhnf DB9 serial cable, 

With the Wisp628 comes a cable which has a DB15 feimile 
plug on one end and which has bare wires on the other end. 
Plug the DB15 female plug onto the Wisp 628 ixxtrd. 

Plug lire I6f877 micnK.’ontrcjller into a breadlxiard 
The necessary circuitry consists of two parts: a regulated 5V 
power supply (Figure 6) and a target circuit including the PIC 
(Figure 7). As these ciRUit diagrams may turn out to be hard to 
read wften scaled to the width of a single MacTech column, the 
code archive includes PDF versions of both. 
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Figure 6: A regulated 5V supply 



* lx 22]jr capacitor 

■ lx O.lpF capacitor 

llie ln4004 Ls a 'foors diode': if you accidentally reverse the 
polarity of your power supply it will prevent damage to your 
PIC. Of course, the diode has its limits. If you happen to use a 
supply that is capable of delivering high currents (>1A)^ such as 
an old PC power supply, the diode will blow and the PIC will 
be damaged after all. 

All that is left now, Ls tt> etjnnect the Wisp628 board to the 
PIC in the breadboard and build a small test circuit around the 
PIC, This is detailed for various PIC microcontrollers on 
http://www.voti.nl/wisp628/nJndex.htmL Here we foais on the 
connections for a 16F877 microcontroller (Figure SI 


DB15 

DBt5 cable 

PIC 

PIC 

pin# 

strand colour 

pin# 

pin name 

1 

biacK 

12, 31 

Vss (Gnd) 

2 

red 

11,32 

Vdd(+5V) 

S 

ye i tow 

1 

MCLB#/Vpp 

6 

white 

36 

RB3A^QM 

3 

green 

39 

RB6/PGC 

4 

blue 

40 

RB7/PGD 


Figure 8: ConnccUom ixHm'cm the DBl^ conneclor of the 
XMs/j 628 ami the target circuil with the PIC 


Figure 9 shows liow' things were wired on my breadboard. 
Be aware that some breadboards, including this one, have 
I)reaks in the middle of the power rails which you need to 
bridge if yoLi want It) use both the left and the right half. Again, 
a high-res JPEG picture is included in the code archive. 


You can Ixjild a .stable 5V supply starting from a 9V battery 
or from a 9V DC power supply, 1 would recoiiimend ihai you 
use a 9V DC power supply rather than a batieiy since llic voltage 
regulator lends to eat through 9V batteries rather quickly. 
Components for regulated 5V ]>ower supply: 

• lx 9V DC power supply or a 9V battery with a dip-on 
adapter 

• 1X 7805 voltage regulator 

• lx green LED 

• 2x 330Ohm resislor 

• 2k lOOlOOOpF capacitor 

• The resislor and the LED are not strictly necessary but do 
make the final check very easy: the LED should light up. 

• Components for the target circuit with PICr 

• lx 33001)m resistor 

• Ix 33kOlim resistor 

• lx red LED 

• lx erysial 

• 2x 20pF capacitors 

• lx ln4004 diode 



Figure 9: The 5K jmmr supply and the target circuit with the 
P1C\ BiM^rything lo the left of the wire hridgi^ in the rails 
forms part of the poieer supply, ewtyihing lo the right forms 

part of the target circMit with the PIC. The red and black lead 
coming in from the top-left arc conmetad lo the 9V 
ballery/poufer-supply. All the other ftying leads 
go to the Wisp 628. 
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Vsini* XWLsp 

Nc3w wc can work on the software side of uploading the 
ledflash.hex file to the target draiit* For this we use the Python* 
based XWisp. Before we can issue the upload commund wc 
need to do Uiree tilings* Firstly, we make a small mcjdification to 
one XWbp source file to enable XWisp to mn on OSX Qiist as 
with the Jal source, you may find that in the latest release of 
XWisp, this modification may not l>e necessary anymore)* 
Secondly, we copy (lie XWisp folder to /usr/bin. And, finally, we 
find the name of the serial f>ort provided by the lISB-serial 
adapter and iLs driver software. 

Modifying XWisp 

In the xwisp_src Folder tliai you downloaded you find six 
files. Drop die file xwtsp.py on Project Builder or Xcode to o]:)en 
it. Use the Kind coniinand to look for CMD_Poit. In tills 
definition, kjok for the line of code saying: 

Name = self.Get^argt Uppercase 0 ) 

After this line, we ncvd to add two lines; 

self.Port “ Name # these two lines are added 
return to use the port name * as is“ 

Please note lliat Python code is indentation seasitive. 
Indents are to Pythtm what curly brackets are to C. You need to 
make sure that the two added lines are on the same intlentation 
level as the line 

if Name “ Hone: 

Just to make sure, die finished version of the CMD_POHT 
definition is shown in the screenshot in Figure 10. 

<Jef CHD^P0liT( self, Nojae = Hone ): 
self.Close^Bus() 
if Home == Hone: 

Noftie = self .0et_Arg( Uppercase 0 ) 
self .Port = n tliese two lines ore ootsen 
return f to use the port noBie *cis is* 

If (Name + ' *)[ ei i 3 J.upperO 'COM*: 

if (lnt((Hame + ’ Of ^ = J) > 
self .Port = + Home 

else; 

self.Port = Name 

else: 

H = seif,Int_VaLue( Name ) 
tf N > 32; 

self-Active.Boudrate » H 
else: 

self.Port - H 

Fif’ut'e W: a scnvmhoi of the CMD_Port moduk 
after the necessanf changes 


Copying XWisp 

Rename tlie folder namerl xwisp_src Folder to just xwisp. 
Now we need to copy the folder to /usr/hin* Unfortunately, we 
cannot simply use die Finder as the folder /usr is hidden* 
Therefore we again turn to Terminal* J'ype sudo cp -R, followed 
by a space, then drag our xwasp folder onto Terminal like we 
did Ixrfore, and finally type /usr/locaf In my case, the command 
looked like: 

$sudo cp -R /Users^Toii/DesktQp/Kvisp /usr/local 

J his copied the xwisp Folder with all its content. Now do a 
listing of the direcuiry /usr/local* 

Sis -F /uer/lDcal 

In llie listing you should find tlie directory xwisp. If you 
wish to convince yourself that we liave not only copied the 
Folder hut its contents tcxi, do a listing of the contents of the 
xwisp directory: 

$ls /ysr/local/3^1sp 


Finding out the name of the serial port 
In lerminal, type: 

Sis /dev 

If you have the Keysfian adatHcr. kx)k for a serial port 
named something like lty*USA19QW181P1.1. The name may 
differ with the exact type of Keyspan adapter you have got. If 
you use a GMUS^3, kxik for a port named something like 
tty.usbserialO- Note down ihe name somewhere as we will need 
it in a moment 

We are nearing yet another inoinem supreme. To run XWisp 
you need Python whicli luckily foniLs [>an of the Apple 
[>evelo|>er Tools. 

Change to the direciory where you keep your .jal, .asm and 
*hex files. In niy case: 

$cd /Voluaes/Data/src 

OK, ready-!' We have xwisp*py living in /usr/local/xwLsp, 
ledflash.hex living in our working directory anti ;i serial port 
living in Alev. Now, on a single line, type this if you have the 
Keyspan adapter: 

$python /usr/iocal/xwisp/xwisp.py part 
/dev/tty*¥SA]9QWi8!Fl.l go ledflash.hex 

Or this if you use the GMU3*03 adapter: 

$pytIion /usr/local/xwisp/xwisp*py port /dev/tty.usbserialO %o 
ledflash.hex 
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If you arc (very) lucky, ihc LE[} connected to pin aO of the 
PIC niicTCKontroiler starts Qaslung- No joy? No need to panic, yeU 
Witli a semp with this many components, it unlikely that you get 
things running the first lime round Which brings us to... 

Trouble Shooting 

stuck? 

Here are some things to check: 

Do you manage Uj run XWtsp? 

When you tiy to iiiti XWisp, Terminal should res|X)iid with 
printing some lines, the first of svhich reads: 

XWisp 1.08, command lino raode 

if it does not, make sure that XWisp really lives where you 
think it lives. 

Arc you really reaching that serial port? 

Usually, you can figure out from tlic error message in 
leniiinal if yoii do not ucldress the serial port correctly (If you 
use I he Keyspan adapter you a\n look at its LED: it shouki start 
nickering during upk>ading of the hex file). If nc)t, check the 
physical connenion between Mac and LLSlkseiial adapter, clieck 
the name of the serial port, and make sure that you have 
S[:»ecilied the complete path: you really need that /dev/ in Front 
of the |X)rt name. 

Does your power supply (still) work? 

Check whether tlie LED in your power sut^ply circuit is on. 
But even if it is on, the voltage over the PIC may have dropped 
to unacceptable levels. Tlie 7805 voltage regulator needs about 
2V headroom to do its work: to acatc 3V output it needs at least 
7V input. With a 9V battery you can quickly drop below^ this TV 
level. If you find that you are going through your 9V battery a 
bit too quickly, you may want to replace it by a 9d2V power 
adapter. A low .supply voltage may lead to all kinds of weird 
behaviour: at 4.5V the PIC may run its program still Line, hut 
prograiuming it tnay have become impossible. 

Is your target circuit correctly hooked up? 

Check the wiR.‘s lx.Hween die Wisp628 and your target circuit. 
Make sure that you really have +5V on pins 11 and 32 and 
ground on pins 12 and 3T 

And finally... is your LED the right way round? 

Well, Pill sure you wouldn’t l>e the first... Tlie flat side or 
shorter lead is [lie cathode and should he t'onnected to pin aO. 
The other side, die anode, is connected to -r5V. When you are 
in doubt whether the LED is connected coneclly, just disconnect 
the PIC-side of tlie LED and connert that side to groimil (0 Volt). 
The LED should light up. If k does not, it is reversed (or there 
is no power). 


Still stuck? 

On WWW,voti.nl you am find some highly detailed pages to 
help you trouble shoot. 

Desperate? 

Tlicrc is a great Yalirx> Group for Jal users; 
http://groups.yahoo.com/group/jainst/ 

Striedy speaking this group is for Jal questions c^nly, but you 
W'ould not lx: the first to start a dist iission aixail the Wisp 628. 

Conclusions 

So there you have it: programming a PIC micrcxontroller on 
a Mac. It takes a little time and perseverance to set it all up. Rui 
it w^orks, have hin! 
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RAPID 

DEVELOPMENT 


By David Linker 

NoCode Browser 



Using the Apple’s Web Kit SDK to make a 
web browser 

Want som rapid dj^jdpment? 

One of the advanta^^es that i.s mentioned atxmt ilie CxK:t)a 
development envinintnent is the well-developed fraineworks that 
aie provided, giving impressive fiinaionality wiihoiil miicli effort, A 
recent addition is Web Kiti whicli is the framework whic:h pRwides 
a fiili suite of a)mponent.s rajuired fcjr weh browsing, and are tlie 
Ixisis of the Safari wel> browser from Apple. 'I'o iilustrate the power 
of Web Kii, Apple explains in the ciocumentation how to make a 
l>rows(:?r with only one line of code. Some folks have expanded on 
tliLs explanation, and in the discussions tliat ensued, others |X)intec! 
out that it 15 possible to write a browser using Web Kit with NO lines 
of code. 'Ibis article will explain how, and discuss some of ilie 
capabilities of Wef> Kit as well 

Fast iane 

In this age of 24/7, just-in-time and accelerated learning, 
some of you may want to get right to the point, while others 
want more details, 'lb sati.sfy the more experienced renders, or 
the less patient^ here is (he executive summary of the main 
[Joints [iccessary: 

Install Project Builder, December 2002, if not already 
installed 

Install Safari, if not already installed 
Install Web Kit 

Make a new Cocoa Application project in Project Builder 
Add the Web Kit Itamework to the project 
Open up the MainMenumib file in Interface Buflder 
Draf) the Webview licadcr file to Interlace Builder 
Add a Custom view lo the main window 
Change its type to Webview 
Add a text Ikjx to the main window 
Connect the target output of the text box to 
takeStringURLFrom in the Webview 


Build the project 

Type a URL in the text box and hit Enter 

Browse away! 

The rest of tliis article fills in the details, and add a few 
niceties along the way. 

Origins and uagkciRound 

A[>[)le built the technology used in its new browser, Safari, 
on existing open source projects. KDE is an open source 
“desktop" environment lor imix, Pan of KDE is a set of tools for 
rendering HTML, called KMTML, and a set of tools called KJS, 
whicli assist with scripting. These two components were used by 
Apple to develop the core classes that are used in Safari. The 
framework incorponiting the.se classes which they developed for 
Safari is called Web Kit, and Apple released the interface to Web 
Kit during the WWDC in June of this yean 

Web Kit provides an amazing amouni of functionality with 
liitlc cITori. It suppons HTML, DOM, SSL, javascript, stylesheets, 
embedding java applets, and a “history" of recent sites. What this 
means in practical terms is that it is possible to incorporate all of 
this functionality in your applications with minimal effort. 

Ap]>lc [>rovided a very terse description of how to do this on 
the pages describing tlie use of Web Kit at: 

http://developer.apple.eom/documentalion/Cocoa/Conceptual/Di 
splay WebContent/index.html 

If you ciujose ‘'Simple Browsing"', there Ls a short description 
of how you can create a lirowser with one line of code, which 
is as follows: 

[twobView tnainFrame] loadRequest: [KSaRLRequest 
requeiJlWilhURLHNSURL URLWlrhStringiurlTt^xt] 1 ] ; 

Of course, there is a fair amount of "wrapper" that tias to go 
arxyund this to incorporate it in a program, including making a 
header file, class file, and all of the connections in the interface. 


David is a lover of Mac OS X, because the rich development environment and frameworks allow his inherent lazynes.s to blossom. You can reach him 
at dtlinker@m3c.com. 
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compatible with MICROSOFT WORD, EXCEL AND POWERPOINT 
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progmui 

IMt will your 

^xpecUilions.' 

- Jeffery Battereby 
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Three High-Performance Applications 


Tkinkfree Write 

Thinkfree Write is a powerful word processing application 
that enables you to create rich, professional quality 
documents and Web pages. You con insert tables, 
images, and clipart, or even apply custom layouts to 
your document...then effortlessly proofread your work 
with the easy-to-use spelling and autocorrection features. 

Thinkfree Calc 

Thinkfree Calc is a full-featured, easy4o-use spreadsheet 
application that con easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities. Thinkfree Cole opens, edits, and saves 
directly into the Microsoft Excel f.xls) brmat, so users 
can seamlessly share documents and collaborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enables you to create high-impact 
presentations including animotion effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint {.ppt} format. 

CyberdrivePlus 

A free, one-year subscription to CyberdrivePlus is olso 
included. CyberdrivePlus provides you with secure, 

Internet file storage and free online software upgradesl 


ONLY 






Thinkfraa and Thinkhu Offic* ore h'ndarrtarks of Thinkfree Coipafattan. All olKer trademarks ond/or regHtered Inodemorks ore properties oF their respective owners.. 














































NaMF that T15Ne! 

Many years ago, was a TV game show called ^‘Name thai 
tune". In it, iJie contestants would try to name a tune in llie 
fewest notes, challenging each other with ‘'I c'an name that tune 
in N notes’*, where N was a small number, and the person who 
named the smallest numl>er got the first chance. 

I had a flashback of that show when 1 was reading through 
a discussion about using Web Kit. The original page, by Martin 
Simoneau, was an excellend article on Cocoa Dev Central HI ling 
in die details on how to make a browser using the line of code 
provided by Apple, and the Web Kit framework. 

http://cocoadevcentraLcom/articles/000077,php 

In the follow-up discussions that were posted, there were 
comments dial the one line of code was unnecessary! Tins 
sounded to me like “1 can name that tune in no notes!". There 
were some very brief descriptions t>r 1 k>w to do this, and then a 
link to antithcT page which described how to do this in sligluly 
more detail. 

http://www.livejoumal,com/users/foxmagic/238347.html 

The essential ingredient is the fact that there is already a 
connection called LakcURLFrom, which will extract the URL from 
a text flckl. This makes it possible to create a functional browser 
without writing any code. 

To do this, there are three es.sential .step that are 
necessary. The first is that you need to have Safari installed, 
since that also installs the Web Kit framework. You can find it 
at: http://www.apple.com/safari/download/ if you don’t have it 
already. Next, you need to have the developer tools, 
December 2002 version installed, if you haven’t already. To 
get this, you need to become an ADC developer, hut 
fortunately ytiu can pin for free. The site to get this from is 
http://connect.apple.com/. Follow the links [low-nload Software 
Developer Tools to find wliai you need. 

Finally, you need to gel the Web Kit SDK. 'I'his is also 
available at the same site, under Download Software -> WWDC 
2003. Once you have installed all of the software, you are 
ready to go. 

Start up Project Builder, and choose New Project from the 
Ffle meniL Pick Cocoa Application from the li.sl, and enter tiie 
name NoCodeBrowser in the Project Name field. Click on Finish. 

Now, we have to add the Web Kit interface to the projeci. 
Cltoose Add Frameworks from the Project menu (see Figure 
D.On the list that comes up, ehxxxse Webklt.framework and then 
click Add on the next dialog. If you want to be very neat, you 
can move the Webkit.framework to the folder Other frameworks 
under Frameworks. Save the project. 



Figure I- Select Add J’rametmtit jrom the l^ojeci menu (ieftl 
then choose WebKit/mmeu^>rk from the dialog 
that comes up. and click Add (right). 


We now^ move lo Interface Ikiilder Click on the little 
triangle to the left of Resources in the project window, and 
double click on Mainmenu.nib. This will opern Interface Builder, 
with a Window called ^Window", In the window titled Cocoa- 
Containers, click on the second icon from the right on the top, 
which .shows a tabbed windosv. Drag a Customview ovct to 
‘'Window", and drop in in the wind< w, Rcsi/se it to fill almost the 
entire wtndtnv, with space to put a text box at the top. Click on 
the second icon fmm the left in the "Cocoa'Containers*' window, 
and drag a text field to the fop of the window, and resize it to 
make it wider. 

Now, arrange the windows .so that you can see the window 
""Maimnenu.nib" in Interface Builder, and the main project 
window from Project Builder. 0(>en Webkit.framework, and the 
Headers folder inside that (Figure 2). At the lx>ttom. there is a 
file called WebView.h. Drag this over to the Mainmenu.nib 
window, and drop it l lie re. 


Cl 6 * ww* _ ^ 



Figure 2 - Chinese the WehVmv elms ftrm the file list in 
PrujaciBuiider (lift), and drag to the MainMenumih 
mndow in InterfaceBuilder (right). 
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figure 3 - iu fbe Show info unridow, select Custom Class 
from the fx>p-up, and tbeti select WchViete as the class. 

Now, select the CustomView in Interface Builder, and 
choose Show Info from tlie Tools menn. On the pop-up menu that 


says Attributes, choose Custom Class, and then choose WebView 
from the list (Figure 3). Close the info window- Now, use ctrl- 
click and drag to make a connection from the text field to the 
WebView (Figure 4)- In the window that pops up, make the 
connection from target to takeURLFrom, and click on connect. 
Save everything, and tlien build, using Build and Run from the 
Build menu. 
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figure 4 - Connect the text field to WehView afui then 
specify that the conm^ction to takeSttingCRLFwm 
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BRADLEY M. SNIDERMAN 
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If you're developing software, you need your valuable work protected with 
trademark and copyright registration, as well as 
Non Disclosure Agreements. 

Then, when you are ready to sell it, you can protect yourself further 

with a licensing agreement. 

I am an attorney practicing in Intellectual Property, Business Formations, 
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Please give me a call or an e-rnaii. Reasonable fees. 
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You can now type a fuU URL in the text field, and when 
you hit enter, the page will load! Note tiiat the UKl must begin 
with “http://**. You can then click in links in the loaded page, 
and those links will load as well You can navigate to secure 
pages, load java applets, execute javascripL, and lots more. Play 
around with it! 


FfATOKF FIIX 

A number of things are missing but easily added to this hrst 
version. First, we c^m add additional functionality wiihoul any 
more code, 

WebView maintains a history of recently visited pages by 
default. Methods exist in the WebView clas,s to back tip a level 
(goBack), go back down a level (goForward), reload a page 
(reload), or stop loading a page (stopLoading). All we need to do 
to miplement these is to add a button for each function, and 
connec:! them to the WebView class and the apprr>priate incthocL 
We can then add appropriate text or icon to each button. 

Another problem is tliat the WebView dws not change ifs 
size when we resize the window. This is easy to fix. Click on the 
WebView in Interface Builder, and then clKK)se Show Info from 
the Tools menu. From the p<ip-up, choose Size (Figure 5). The 
box indicates die WebView object, and the straight lines indirale 
a fixed relationship. If the lines are siraighi wUliin the object, the 
size will not change with a resize. If the lines outside are straight, 
the relationship lo the containing window will nor change. If all 
of the outside lines are straight, the object will be centered with 
a resize. If you click on a line, it turns into a “sjuiog* which will 
allow re-sizing. You can do the siune thing to all of the odier 
ol>jeci, such as the buttons and the text box, to <-onlrol their 
l>chavior during resizing as well. 
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figure 5 - Click art the interior lines in the box (kfi) to 
turn them into "‘springs"(right), to allow the WebView 
to resize along with the mndouK 

The final refinement is to change all of the menu items 
that refer to “NewApplication” to refer to “NoCode Browser”. 


A picture of the main window in my finished version is in 
Figure 6. 


#aa 


tIoCcKit komer 


figure 6 - ihe ft ml appeamnee o/the main window, after 
adding back foruwd, rekml, and stop buttons. 


Resourcls and additions 

Although diis demon.stration is impressive, there are a lot of 
missing pieces if we were to 117 lo make a complete program. 

If you click on a link wliich sliould result in opening 
antnher window^ noilitng happens. I'he same thing goes for 
email links, download links^ and anydung oilier than navigation 
to another page. 

ITae currem version has no error checking, and no error 
messages. Probably the worst, obvious omission is that if Web Kit 
framework Is not loaded, that is, if Safari has not been in.stalled, 
the program will not work and will probably crash, Methrxls for 
dealing wddi tills are explaineii in the tutorial pages at: 

http://developer.apple.eom/docymentalion/Cocoa/Conceptual/D 

isplayWebContent/irTdex.htfnl 

WebKit has a number of liooks to allow changing or 
enhancing ils l>ehavior. The use of these links is also explained 
ai [he tutorial pages. 

Finally, there is a Wel> Kii discussitm list at: 

http://lists.apple.com/mailman/listinfo/webkitsdk-dev 

in additon to providing impressive functional try thar you 
can use in your programs, WebKit provides a dramatic 
demonstration of the power of the frameworks available 
under Mac OS X, allowing you to create a web browser 
withoui writing a single line of code. What other platform lets 
you do that? 
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Multiple fonnats. Multiple platfonns. 
Complex installers. 

Aladdin solves the compresskm and instaUatim puzzle. 


Trying to figure out how to handle multiple 
compression fonnats and platfonns? 

The Stuffit Engine solves tfje compression puzzle. 

Aladdin’s Stufflt Engine SDK; 

> Adds value to your application by integrating {powerful compression and encryption. 
>• Is the only tool that supports the Stufflt file format. 

> Provides a single API that supports over 20 compression and 
encoding fomiaLs common on Macintosh, Windows, and Unix. 

"> Makes self-extracting archives for eitlier Macintosh or Windows. 

>■ Available for Macintosh, Windows, l.inux, or Solaris. 

Stufflt Engine SDK" 

The power of Stufflt in your software. 


Licensts sturt tis low 
as $99/yc‘sir 

To learn more, visit: 
www.smffiicom/sdk/ 




Looking for the easiest and fastest 
way to build an installer? 

Stufflt InstallerMaker completes your puzzle. 


It’s not enough ju.sl to write solid code anymore. You still have to write an installer 

for your users. Stufflt InstallerMaker makes it simple and effective. 

>• Stufflt InstallerMaker gives you all the tools you need to install, uninstidl, 
resource-compress or update your software in one complete, 
easy-to-use package. 

>• Add marketing muscle to your installers by customizing 
your electronic registration form to include surveys 
and special offers. 

► Make demoware in minutes. Create Macintosh 
OS X and Macintosh Clas.sic compatible installers 
with Stufflt InstallerMaker. 

Stufflt InstallerMaker 


Prices start at $250 
Ttj learn more, visit: 

insialierTTiaker/ 


m\5ystenis 

www.stufnt.com 
(»31) 761-6200 

O 2002 AJoddin Sysisms, 

Inc. Sfufflt Stufflt 
InslolbriMrokef. and Shiffh 
Engina SOK qru Irodumorkf 
of AJoddIn Systems, Inc, The 
Aladdin kiga h a regtslured 
Irqdumark. All idtiwf produch 
ore irctdemcrb or registered 
frademarlcs. of (heir respective 
holdbfs. All Rights Reserved 


The complete installation solution:'' 














MWSF '04 


By Michael R. Harvey 

Round-up of what we saw this year 


Aivnoitncemen'i^, AnnouncjiMIiNTs, Announcements 

TIils MucWurld Expo saw no earth shaiteririg releases, but u 
whole pile of new and updated releases form companies across 
the speanim of Mac-dom. Some of those annoimcmg, or 
releasing, new and updated products included Microsoft, with 
their Office 2004 for Mac. and TimbiikZ, widi two new cases 
added to their line cjf packs and lapioj) cases- There was also 
news from Oxford Semiconductor, showing off their OXFW912 
FireWire 80f) to IDE bridge chipset. lANDesk Software 
demonstrated their latest lANDesk Manageineni Suite 8, while 
AFl'O Technology announced that their host htis adapters hilly 
support Ixnh the G5 prcK'essor and Panther Whai else? Head on. 

Apple 

Serious iron for the rest of us 

'the GS proc’essor finally made it in to the Xseive. With two 
2,0 GHz prtK*essors (Kicked in, the new Xserve is capable of ever 
greater (>rocessing jxaformance. You ain chec’k out Applets 
website to see all the pretty gniphs showing r>ff the horsepower 
of this revision. NtJt so widely known about the new Xserve GS 
is that it now has a hardware RAID built fa, whkh gets you 
hardware RAID level S, 110Mbps serial ATA drives, and set 
rebuilding in the backgujinid. Very gt>nd news. 

Alnu>st mort^ imjxKtum for network administnitnrs is the 
u]xiated Xser\'e RAID. With capacity up to .5,1 Terabytes, 
fourteen hot swappalde drive bays giving you a SiA4 per 
gigabyte price point, this ujxlated unit places itself in a very 
attractive position for any network or server adininisiraior 
looking to expand iheir storage. There is al.so hardware set 
rebuilding in the l>ackground, just like the Xserve G1.1 his ability 
in the Xser\'e RAID is a firmware update, and slioukl be 
updateable on older Xserve RAH) units, 

Wliiiher G5? 

I'he G5 desktop system has been around for a few inondis 
now, so where do software dcvelcjpers stand on ujxlating their 
applications for the 64-bit architecture? 1 decided to get a sample 
answer by talking to folks whose programs really Ireat the snot 
out of hardware. Alias, the makers of Maya, and Discreet, makers 


of Combustion (who just released version 3 at the expo). Both 
companies said that they saw treiuendous impn^venients in 
performance running their current versions on G5 hardware, 
without any patches to take advantage of the new hardware 
advancements. Each also ran into a few compatibility issues, 
none deal breakers, and all hilly documented on their web sites. 
Last, boih Alias imd Discrc^ei said they currently have no official 
plans to update their applications to lake full advantage of the 
G1 architecture, citing ihe already significant s|xcd Ixxjst they 
currently have. It is somedung tliey are always looking at 
lK)we\T'“r, so don't expetl them to let the advantages of the G1 
wait h)r ttx> long. 

Drive Savers 

1-8(XM4(F1904. The one plione number every admin has handy, 
and prays they never have to calf These folks were at the show, 
showing off st)me of the more extreme axovery jobs theyVe 
received- Tlieir enler]>rise busines.s is grtjwing. Tliey are more 
and more able to handle really big recovery jolis. Don't worry, if 
you ever need them , they will be there. 



Sam Whelun is the Senior Director of Quality A.ssurance for Commercial Print Products at EFt, Inc. He lends a QA team whose engineers test and 
release software targeted to customers on Mac and Windows ijlaifomis as well as testing hosted Web Products. 
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MAC OS X PANTHER 


ALL YOU NEED TO KNOW ABOUT PANTHER 


Want to know whaVs 


new in Panther? Turn 



to the one book with 
aii the answers. 


Sams Teach Yourself 
Mac OS X Panther 
All In One 

by Robyn Ness and 
John Ray 

ISBN: a«72-32603-5 
$29.99 US 


Mac OS X 
ilVIovie & fOVD 
iHunes & iPhoto 
Internet 
Mac Hardware 


Tfounett 

Mac OS X 
Panther 


Om the Ammira 


Sams Teach Yourself Mac OS X Panther 
All in One Is designed to teach, in one 
book, the Mac user how to easily work 
with the hardware, the operating system, 
and key applications. Rather than focusing 
on a single product, the book covers 
multiple products and technologies 
together in a logical fashion. 

Topics Include: 

• Understanding the Mac OS X Panther 
interface. 

• Burning CDs and DVDs with iDVD. 

• Playing and organizing MP3s and 
digital music with iTunes. 

• Digital photography with iPhoto. 

• Editing digital video with iMovie. 


Visit www.amazon.com/samsbooks to download an overview 
of Panther’s new security features 


OTHER GREAT SAMS BOOKS ON PANTHER 






{Jr- 


.W"' # 

Mac OS X 
Panther 


UNLE.ASIIED 


ILife in a Snap 

by JInger Simon 
ISBN: Oe72-32577-2 • $19.99 

Available Dec 2003 


Mac os X Panther in a Snap 

by Brian TIemann 
ISBN; 0^72-32612-4 • $19.99 US 

Available Dec 2003 


Mac os X Panther 
Unleashed 

by John Bay and IVifffam Ray 
ISBN: 0-672-32604-3 > $49.99 US 

Available Jan 2004 


amazon.com 


sAms 


vvww.samspublishing.com 



Amazon.com is the registered trademark of Amazon.com, Inc. 
























: ' -* iiiitiitiitiir 1 tiiiiitiiiuii i 

















& 

1—r- T' I -- y 


Dantz 

T'he big announcemenl fvum DanU lim time around was 
version 6.0 of Ketrospecl for Macintosh, A mullitucle of 
improvements have been rolled into the new version. High on 
the list is the removal of the I TB limit present in previous 
version. You can now back up data sets and volumes up to 
1,000 TB, Fibre channel support has lieen added, as well as the 
ability for backups to span mulliple FireWire and USB disks. 
Obviously, the latest Macs and o|>erating systems are now 
supported, and Dantz also includes a disaster recovery CD with 
Mac OSX 10.5d, 

NirropiA 

Timbuktu Pro 7.0 

Timl>ukiLi l*ro has been the gold standard for remote cuinputer 
control for years. Version 7.0 only improves on an already great 
product, Ueleased in r)ec‘eml>er, version 7.0 adds Faniher 
suppori, including the ability to handle the fast user switching 
feature of 10.3. You ciin also now control how much color 
information Ls being sent to the controlling computer from tlic 
controlling computer. Pop up tip balloons arc* nctw part of the 
program to hel[> you figure out the functions of the not always 
clear icons. Additionally, some features that in pa.si versions 
were controlled with AppleScripts are now part of the 
preferences, making set up and control easier overall. 

Net(>ctopu.s 

Ncujpia pa*viewed version 5,1 of netOctoptts at tlie show. The 
main new' feature of this will be the Softwaa" Delivery Sysiein 
(SDS). It will be added to what Netopia is calling their 
nclOciopus Enteq^rise Systems Manager. There is a long list of 
features that this system will over. One new feature that will 
certainly take a load off your network is the ability to resume 
inLerrupicd downloads without having tlie re-download the 
package from the staging server. I’he new version will he 
relea.sed by the end of the first quarter. 

LaCie 

'Hie biggest thing coming from LiCle this show was what they 
very mcxlesily call the Bigger Di.sk. It should lx.* available by the 
time you need this. What it is is a lx>x stuffed with four drives, 
and the necessary hardware to make it look like a single one 
terabyte volume. The internal hardware uses RAID 0 and 
spanning to present die host computer widt one logical drive. 
Hence, the host machine requires no drivers to make use of the 
disk. It's got three interfaces, FireWire 800, FireWire 400, and 


UiiB 1,1/2.0. It is also equipped with a temperature sensing fan 
to help keep it cot>l, as well as running quieter. It'll have a price 
of $1199 when available, 

PROSOtT 

Prosofi was showing off the updates to two of their products, 
Data Rescue, and Data Backup, Data Backup is a compIcTcly 
new^ program, built from the ground up by Prosoft. 
Previously, they had licensed Tri-Backup from TrbEdre 
Software, When that agreement ended, they engineered their 
own version. The other application updated was Data Rescue. 
Tfii.s tipdate added the capability to do content based 
recoveiy, as well as recover images from digital cameras. 
These two utilities, along with Data Recycler, are now also 
bundled into the Data Safely Suite. 

Now SonwARE 

The folks from Now Software showed their la Lest uyxlate to Now 
Up-To-Date and Contact, bringing the version to 4.5.1. They 
added Panther compatibility, as well as sialiility enhancements 
and other refinements. Tltey also talked a liii alxjut the next 
major revLsion, version 5.0, due later this year. Tliere^s nothing 
official, yet, but it’s going to lx the biggest, most complete 
update to the program ever. Keep an eye out for it. 

Jdst piain coot 

MacWoiTd always has a lot of consumer oriented prcxlucls 
on display, Tliese are some of the alisolulely coolest gadgets I 
came acnxss at tlie show, 

01,0 

Back in NovemixT, 1 reviewed Digital Lifestyle Outfitters 
Transfxxl all-in-one F'M transmitter and car charger. 1 loved tr. 1 
also had rw^o complaints. One, it tlklnT swivel left and riglii. 
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Two, they liiidn'i yet come out with one for the 3G iPods. Well, 
1 can coinphiin no triore. Tliey itad on di-spUiy, and availahle lor 
sale, the IVanspod FM, Not only is it designed for the latest 
iPods, it has the ability, on the extender arm, to swivel left to 
right. Add to tliat a digital tuner, and auxiliary output, and you 
Itave the best of in car iPod accessories. They also liavc a wide 
variety of other accessories, including some very interesting 
cases. Clieek them out at www.everythingipsKLc oin. 

Harmony 

These guys are great. They had on display their late.st 
offering, the S.ST-h59 Family renioie. Designed to l>e easier for 
everyone in the hemse to use, with se)>arate direction and 
activtiy keys, making it easier for the younger ones in the family 
to get things going. It also has a greal price poini. The one tiling 
yOLi sacrifice on this remote is tlie included TV listings in the 
remote. You get the service for tw^o months, then must pay a 
yearly fee. Stilt, this device Is by far, one of the nicest remotes 
you can get to feed your need to channel surf. 
wwvy.harmonyreTinotexom. 

MacAUy 

As always, MacAlly had a wide vaiiery of offerings on 
display. New to their elan of products were a line of backpacks 
and laptop cases, ail quite nice kxjking. The one tiling that 
caught my eye, however, was their retractable cable kit with 
multi-function tips. I wasn't able to find out too much about it, 
and it's not yet even on their welisitc. I am very inLere,sLed to see 
something like this that can reduce the cable clutter in my bag, 
and will lie following up on this one. 

Altec Lansing 

The inMotion portable iPod speaker set was far and away 
tlie coolest offering the folks from Altec Lansing had on display 
at MacWorld. Compaa, and well designed, tliese speakers were 
specifically designed to support the iPod, and give you room 
filling sound from a very small form. These speakers run off 
either A/C power or from four AA bailericcs. When plugged in, 
the inMotion will also charge your iPod, while the batteries can 
run for 24 hours straight. These are an absolute must of the 
traveling iPod user, www.altedansingxom 


O'Reilly 

Thai name .should be knowm far and wide in the tech 
community. O'Keilly has, ahnosL literally, a ton of w^ell 
received tech focused books in publication. At the sliow, 
they had them al there, as well as one new title that doesn't 
quite fall into the techie category (perhaps). The Best of The 
Joy of Tech is a presentation of tlie online comic scries by 
Nitro^ac and Snaggy. Anyone who has been involved in the 
Mac community for any amount of time will get a big laugh 
out of these panels. They also had an excerpt from David 
Pogues new book, iLife ’04, The Missing Manual, on the floor 
practically moments after the suite was announced during 
the keyntJte address. First impression is that this new 
addition to the Missing Manual series will up hold the good 
repulation these books have. 

“THt SHOW I LOOR IS CLOSED/ 

Those are some of the sweetest words you can hear on 
Friday aftcT a long week of Expo, Thi.s years edit ion had a lor 
going for it. There were no really big, gee whi;;: announcements, 
but there w^as a lot going on. What we covered above was only 
a fraction of all that was wrilien and lalked aliout I hat week. As 
for the show^ itself, the Boor, as well as tlie conference sessions, 
were w'ell attended. Most everyone, exhibitor, and attendee 
alike, .seemed lo feel they got their moneys wfvrth out of San 
Fraticisco this yeai. 
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SOFTWARE 



By Da ve Wooldridge 


Sweetening the Deal 


Increasing Sojlware Sales with 
Purchase Incentives 


List month, we explored ways to enhance your software 
demcjs and trialware in the hopes of turning more users into 
customers. While those various taak’,s should help inereasc 
sales, they certainly won't entice ewr\fone. Not eveiy person 
who downloads your softw^are is going to want or need your 
product, hut w^hat about those holdouts who continue to use 
11 nregistered versions? After several sessions, they obviously 
have tbuod your product to i>e useful or enteiiaining* or else it 
would have ended up in their trash bin long ago. These are the 
users w'ho are definitely interested in your software, but have 
been reluctant to take the final purchase ,step. There are typically 
three reasons that might prevent a satisfied user from becoming 
a registered customers 

1. Price. 

2, Piracy. 

3- Procrastination. 

Ah, yes, the three H's preventing purchases (try repeating 
dial longye-iwister muliiple times). Developers may recognize 
these three sul)jecLs as contributing factors in the ongoing 
erositjn of softwaie sales. Since the three P’s will probably 
always be pari of the software landscape, programmers often 
turn a Idind eye, thinking there is little they can do to battle 
these global problems. Sure, there w ill always be users w^ho 
complain about your prices. And there’s no way to prevent 
piracy (if hackers want to pirate tir crack ytair software, they will 
find a way to do itJ. As for procrastination, don’t w^e all try to 
avoid spending money unless absolutely necessary? The key is 
to change our perception of these problems* Instead of giving up 
the battle, try to find creative avenues to gain some ground. You 
may not win over all of those users, but you’re sure to capture 
more sales than if you did notlung. 

TliLs month, wee’ll inve.stigate methods to "sweeten the dcaD 
for those satisfied - yet uiuegistered - users, whth the goal of 


finding just the right incentive that finally motivates them to 
purchase a software license. 

Pricing Strategies 

'rhe price of your software Ls a good place to start. If your 
product has been well-received wath good reviews and 
testimonials, but sales are still below reasonable expectations, 
you may que,stion the price as a pc}s,sible deteTrenu 1'lie natural 
assumption is that the price may be too high, hut you ,should alstj 
lake into consideration titat the price might Ik" Iocj low. 

Too low? Is titat even possible? Yes, price directly affects 
constimer perception of your software, Let'.s use a pastry shop as 
an example. A pastry shop decides to ftlace their cinnamon rolls 
on sale for half' [:)rice. Since they are normally priced at .'$2.00, 
people nock from all over town to btty them for the special .sale 
price of $ 1.00. The shop owners are so pleased w'iih the resulting 
profiLs tsince each cinnamon roll only costs $0.10 to make) that 
they decide to drop the price even lower to $0.25, in the hopes 
of selling even more volume! To their .surprise, sales sharply 
decline. No one w^anied to buy a cinnam£)n roll for only a 
quaner. Wliy? Becau.se the j>rice was so cheap that people 
l:>elieved there had to be something wrong with the cinnamon 
rolls* When rite price clipped beiow' a reasonable level, the 
general a,s.sum|)iion was that the cinnamon rolls were probably 
stale, \layokr inventoiy, 

.Vlany shareware devetopers fall prey to under estimating 
the value of their products. If the competition is selling a 
similar product for $39.95, don’t sell your product for only 
$5.00. Placing one copy of your prodiict on a w^eb .sender as 
downloadable shareware removes the costly overhead of 
manufacturing a boxed retail CD-HOM package, so as 
developers, we often want to pass the savings onto the 
cusiomer. linforiunately, this kind of low-l)alj (iricing .siraicgy 
will not deliver a windfall of sales, but will instead create the 
perception that your product is not of the same professional 
ciuality as your competiior’s* In ihe eyes of the consumer, 
price is directly relaled to qua lily, reinforced by die popular 
phrase “you get whar you pay for," For $39.95, customers 
expect a quality product and support from your competitor. 


Dave Wooldridge is the founder of Electric Butterfly (www.ebutterflycom), rhe web design and softw^are company responsible for HelpLogic, Stimulus, 
UniHclp, and the popular developer site, RBGatage.corn. 
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Fcir only $5.00, the elemeni of risk is introduced with your 
prociucL You may he seen as a hobbyist with an uncertain 
future instead of a stable, professional software company. 
Sure, it’s only $5.00, so the risk is minimal, but that's $5.00 
that etmld have been pul toward ihe “safe" pimchase of the 
competition's $39.95 product. 

Beyond the fact that low-end pricing can create maccurate 
consumer perceptions, it can also negatively affect the future of 
your business. If you're selling small utilities diat only offer a 
single feature, rlten pricing these types of products Linder $10 
may lie appropriate, bul for larger multi featured applications, 
prices that fall below $10.00 can often prevent your t>usLnes,s 
from growing. Managing customer support, sales inquires, 
product marketing, and programming lakes time... and time 
equals money. If yoirrc currentiy a one or two persL>n sliareware 
operation, youll have to sell a dauntingly high number of $5.00 
licenses to generate enough revenue to afford advertising or 
a dd i t i( mal e i n p ioyees. 

Doing the math presents a sobering view of your 
business projections. $ay you w'ant to purchase an online 
banner adverlisement on a popular software site. The banner 
ad campaign (to advertise your $5.00 product) costs $600.00 
per month. If you utilize an e-commerce partner (such as 
Kagi, eSellcrate, RegNow, RegSoft, DigiBuy, Reg.Met, etc.) 
who subtracts a processing fee from every software sale 
(usually an average minimum of ,$1.00-$3T)0 per 
Lran.saclion), ihen for tlie sake of this example, let's say $1.00 
is tlie order jjrocessing fee. That means for every S5.00 sale, 
your business receives a net profit of $4.00. You would need 
to sell 150 software licenses in only one month just to break 
even from the $600.00 advertising expenditure! Raising y<Hir 
product's price to $15 or higher drastically reduces the 
number of licenses you need to sell to pay for the 
advertising. Even with a $2.00 order processing fee, a net 
profit of $13 requires you to only sell 47 licenses to break 
even, A $23.00 net profit ($25.00 price) requires only 26 
licenses to l.^e sokl 

Fm not recommending price gauging, by any means. The 
examples are only to illustrate how your pricing strategy can 
greatly affect a rnulliiude of business facitjrs, so any 
decisions to either raise or lower your software prices should 
not be done impulsively. Don't lower your price because one 
angry user on an fniernei newsgroup condemned your 
product for not being free. No miuicr liow affordable you 
make the price, there will always be a select few individuals 
who complain that it is too high. And don't lower your price 
in the hopes of curbing piracy. Price usuaMy has nothing to 
do wuth piracy. It doesn't matter if your product is $5.00 or 
$500.00, hackers crack software for the love of the challenge. 
Take tlie time to study the current marketplace and your 
competition. The trick is to set a price that effectively 
conveys quality while still beating competitive prices. If your 
compeliU)r’s product is $39.95, try pricing your product at a 
conservative $24,95, If you offer both a CD-ROM version and 


a dowmloadable version, build the manufacturing cost (let's 
.say $5.00) inio the CD-ROM price while giving a discount to 
your download customers. In that situation, you may want to 
try $29.95 for the CD-ROM version and $24.95 lor the 
download version. You can always increase the price as you 
release new^ versions with additional features. 

If you do decide to lower an already established price, 
you'll need to be careful how you position the change so as 
not to Liyrsci existing customers. If a customer paid the 
original $34,95 price last month and discovers that this 
month, the price has been reduced to $24.95 for no good 
rea.son, then expect to receive .some angry e-mails. The 
saving grace is that customers perceive items going on sale 
for a limited lime as an acceptable reason for lowered prices. 
Purchasing the item at regular price, not knowing that it 
wanild go on sale a montli later, wall undoubtedly cau.se 
irritation, but consumers will not harbor a grudge tow ard the 
s( >ftwa re tieve lope r/ pi i b 1 i s h e r 

Declaring a sale price attracts new customers, especially 
satisfied users who regarded the original price as too liigh to 
warrant a purchase. Rut don't just shite the new sale price. Lei 
consumers know exactly what they are .saving. NOW ON SALE: 
Only $24.95 - 5ave $10 of the regular price of $34.95 for a 
limited rime! lftho.se satisfied users have been holding out due 
to price, remove lliat barrier wiili a special .sale opp<irUinity that 
they won’t want to miss, 

Tii-rei> Editions 

On the opposite end of tl:ie spectrum, tliere are software 
products that sell for several hundred to several thoLcsand 
dollars each. These applications are usually professional tools 
geared tow^ard software developers, graphic ariisis, web 
designers, musicians, engineers, etc. These products used to 
be considered niche markets wiih smaller customer bases, so 
their expensive [)rice tags would help finance the high cost of 
developing and supporting such sophisticated tools when the 
%^ohime of sales couldn't. In today’s world of affordable 
CD/DVD recorders, scanners, digital cameras and camcorders, 
consumers are finding an everyday use for these high-end 
softw'are tools, 'I'hey don't need all of the professional 
features, so they can’t justify paying tlie high prices. Instead 
of ignoring this viable audience, many companies arc 
releasing tiered editions of their software to cater to the 
consumer, prosumer, and professional markets. 

Adobe Photoshop has been a longtime favorite among 
graphics professionals, but its price leaves it far outside the 
reach of most consumers’^ budgets. To take advantage of the 
growing popularity in digital cameras, Adobe released the 
affordable Photoshop Elements, a .striped down version of 
Photoshop that incliKle.s the essential features needed for 
modifying and enhancing digital photos and .scans while 
simplifying the process with step-by-step wizards and user- 
friendly guides. Adobe can't lose with this strategy, since 
Photoshop Elerncnis, either l>undied with a scanner/digiial 
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camem or purchased through retail, introduces new users to 
the power of Photoshop, Consumers will coniinue lo 
upgrade lo the lalest version of ?ht)toshDp Elements and 
tech-savvy prosumers will eventually feel ready to graduate 
to the full-version of Photoshop. Hither way, Adobe has 
created a solution for all levels of expertise, so as not to miss 
the sales opportunities emerging in the growing digital 
lifestyle arena. 

For business and development tools, it’s common to see 
three tiers: a standard edition, a professional edition, and an 
enterprise edition, Different companies use different names, 
hut the end result is that they have the ability to offer several 
versions, cacli with a distinct price point and feature set, 
targeted to a specific market (see Figure 1). The standard 
edition may offer only basic features, while the professional 
edition adds advanced features. The enterprise edition then 
integrates mulrhuser collaboration and networking with the 
pro features. 
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Co^JeQuiver - Code Snippets Organizer for Mac De 


^ ht t p: / / www.c odequt ve r .com f 
Products I Purchase ^ 


Support 


CodeQuiver is available In 3 convanieni editions, so choose 
the version that best suits vour needs Already own the Lite 
Edition? Check out our special Upgrade Offers . 


Lite 

ar 

sr 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

S149S 

BUY 


Pro 

Ef 

0 

0 

0 

0 

0 

0 

□ 

□ 

□ 

S24.95 

BUY 


Enterprise 

0 

0 

0 

0 

BT 

0 

0 

0 

0 

0 

S3$9& 

BUY 


Search Engine 
Compact interface 
Sirrgle User Database 
Syntax Cotortng 
Drag 'n Drop Code 
Store URL Favorites 
Password Protection 
Multi-User Database 
Open Record Locking 
Network Compatibie 


Figure /, Delmuimg on }m(r product’s feature set, 
ojfering tiered editions wili at tract a broader 
audieyice, allouing custtmiers to purebase the 
lemon that best sidts their needs and imdget. 


Why go to all the trouble of relea.sing multiple editions of 
the same product? Because a one-person home lousiness 
operator will not want to spend a lot of money on enterprise 
features that he/she won't use. Don't lose a potential sale. Offer 
a single-user personal edition to cater to those small business 
owners. As their business grows, provide an upgrade path, so 


that they can easily move up to the next tier if those features 
bec:t)Tnc necessary to their Imsiness. Giving con.sumers a choice 
allows diern to purchase the feaaires that test suit their needs 
and budget. 

Even if your software sells h)r under S 100.00, 
establishing tiered editions can increase sales. Those satisfied 
users who refused to pay for unneeded features can finally 
purchase the appropdaie version iliat meets their comfort 
leveL In Figure 1, all three editions and their respective 
feature sets for our fictional CodeQuiver product are listed 
on the company web site for users lo compare. These kinds 
of checklists are a great way to easily showcase the 
differences bemeen the tiered editions. Not including them 
in your documentation, marketing materials and web site will 
only invite countless u.sers to e-mail you asking how they are 
different (which wall quickly consume too much of your 
preciou.s developinent time). 

For products w^ho.se feature sets can't easily be divided 
ttiio three marketable editions, anotlier approach is to keep 
your full product intact and simply offer a striped-down, free 
Lite version as a way to attract new users. What makes a free 
Lite version different than the usual trialware is that being 
free, word of mouth spreads faster and people are usually 
more eager to download free tools than those that expire after 
30 days. An effedive, free Lite edition is one that offers 
encjugh features to be useful, but leaves out the most 
clesiralile features found only in the full commercial version. 
Free Lite versions cio not display ihe typical nag ,scTeens 
found in shareware* so tlieir [>rime objective is to produce 
loyal users who are con.stantly recommending your product, 
driving traffic to y()iir web site, rhe retail indu.stry calls this a 
“loss leader" with ihe goal that people cfjme to d{>wnload the 
free late version, but while they are visiting your .site, end up 
purchasing the full version or some of your other products. 
For this strategy to really work, your web site needs to 
include finely tuned marketing messages that heavily promote 
the benefits of iij^grading to the full commercial version. Offer 
special upgrade pricing for all Lite users. Why would you give 
Lite users a discounted upgrade price when they never 
bought anything to begin with? Simple. Reward customers for 
being loyal users, since they could just as easily buy your 
cofiipetition s product instead. The sole reason that the Lite 
version exists is to help sell more software, so make that 
purchase decision easy for users to make. 

If yon do decide to offer a free Lite edition, just remember 
that users will expect you to maintain and update the Lite 
version. Thi.s can be a draining overhead of development and 
support costs if the Lite version does not effectively increase 
sales for the full commercial version. On tlie Hip side, it also 
opens an amazing himdling opportunity^ for you as well. B 
your softw'are i.s an audio/video editor, music jiikeb{)x or 
multimedia viewer dial could be used in conjunction witli a 
MIDI keyboard, MP3 player, scanner, digital camera or 
camcorder, hardware vendors may be interested in bundling 
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your sofmare with their products. The catch is that most 
manufacturers will not bundle lime-limited trial ware or 
cripfDled demos - they want working sofm^are that w^on t 
expire, so they can advertise that their hardw^are products 
include full-functioning software [hat ertliances the user 
experience. Getting your free Lite version distributed as 
bundled software is a great way to introduce new users to your 
product. Once they are regisiered users of the Lite version, you 
can offer them special upgrade opportunities (for tlie full 
version) to get even more out of their software experience! 

D.\ngling iiui Carhot 

With cracked software and .stolen serial numiners so easy to 
find on the iniernet, simply offering a sale price may not motivate 
users of pirated software to actually buy your proditct. As slated 
earlier, no tnatier how low^ you price your prcxiuct, if hackers 
w-ant to crack your application, theyT do it for the love of the 
challenge, not to save money. Don't w^asle your time trying U> 
find w'ays to convert hackers into cusKmiers. Your efforts should 
be directed at the casual consumers who stumble up{)n pirated 
.softw^are and serial numlxtrs on the various war?, sites. Those 
wilt) feel guilty might decide to lake advantage of a sale price in 
order to replace their cracked version with a legitimate copy, liiit 
with the popularity of file sharing, don't hold your breath waiting. 
Sure, you could spend lots of liine blacklisting stolen serial 
numbers on warz sites and sending warning e-mails to illegal 
users. While those defensive tiieasures may stem the tide of 
piracy just a litile, they won’t sell mow licenses. 



Figure 2. While ihe Jree exira^ add value to the purchase 
price, this ficHouai oJferaL^o includes an expiration date 
as an incentim to place an order sooner rather than later 


So how do you convince a satisfied user to purchase 
your software instead of downloading a pirated version? 
Desperate times call for creative solutions. Offer something 
to consumers that cannot be found on a warz site or file 
sharing service. In Figure 2. as a value-added bonus for 
upgrading or purchasing our fictional CodeQuiver product, 
customers receive a Solutions library of more than 500 code 
snippets in various programming languages. What’s nice 
about this particular bonus is that the items come formatted 
as a database library that natively integrates with 
CodeQuiver, strengtliening the usefulness of the product 
(which is a code snippets organizer). Plus, as a digital file, 
it can be easily delivered as a download, so no extra 
shipping costs are recjuired. (')ihcr downloadable items that 
work well as value-added extras are ebooks, plugins, related 
helper utilities, etc. To effectively attract customers, make 
sure the bonus item is related to your prodiici in some way, 
so tfiat it also serves to enhance their experience with your 
software. For example, a music production tool could 
include a free drum loops collection or audio effecMs plugtns 
with every purcliase. 

To help prevent digital bonus items (such as 
CodeQiiiver’s Solution.^ Library) from ending up as a pirated 
commodity as well, do not include it whth the licensed 
download of the product. Require eligible customers to 
register their license (Miline to gain access to n special 
passwx.>rd protected download site, Kncr>^pl the download 
with the customer’s serial number or some similar method 
that would convince customers that illegally distributing this 
bonus item could be traced back to them. Obviously, an 
experienced hacker wotikl see through I lie prniective guise, 
but the purpose of this subtle scare tactic is to prevent 
average customers from making the bonus item available on 
file .sharing services, etc. 

If your product is only available as an electronic 
download, then you may want to avoid offering bonus items 
that require physical shipping, such as printed books, training 
videos or apparel. Unless you are already shipping a CD-ROM 
to your customers, the added expense of packaging and 
mailing the bonus item will drastically reduce your pr(^fil 
margin (especially if you are shipping it overseas). You may 
not make enough money selling a S39.95 license to a 
cu.stamer in Italy if it C()Sts $26. IH to ship the free bonus hook 
across the Atlantic Ocean. 

Offering free software that you’ve created or some value^ 
added item that does not incur tnanufaciuring costs or 
licensing/royally fees wall also help you preserve your profit 
margin. For example, Figure 2 s Solutions Library was 
compiled by CodeQuiver’s creators, so bundling it with 
CodeQuiver purchases only cost the developers the initial lime 
it took to produce tlic bonus librar>\ .Since CodeQuiver is a 
relatively inexpens we product, a Solutions Library made by a 
third-party developer that requires a licensing fee or royalty 
payment for each unit sold can negatively impact the net ]>rofit 
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of mch sale. Cakulaie Uie ctKsi of goods before finalizing a 
special offer lo ensure that your profit maigin remains 
acceptable. The goal is to increase sales so that you can grow 
your business, not go t>iii of business. 

Do not offer product documentation or support as the free 
l>onus items, lltese are etemenis that customers exjx^ct to 
automatically receive wiili a paid license. Die only time support 
qualifies as a value-added ilem is if you offer paid support plans 
as separate purchases. Tor exam]>le, many developiiienl totals 
include a certain level of ba.sic support, but beyond the initial 
offering, paid premium supptjn plans are available for customers 
w ho need ongoing priority asSsistance. If your marketing effoits 
are targeting professional businesses, offering your Gold Support 
Flan (a $30().(X) value) free with every purchase of your product 
might Ise quite attractive to business executives, engineers, 
programmers, etc. 

Always slate ihe monetary value (even if estimaterl) of your 
lx)nus items. Informing cotisutuers of exactly how' tniK li money 
they would he saving hy taking advantage of your atiiazing offer 
can be the key factor that a>nvinces them to buy. A user may 
not know' that the free audio effccLs (ilugins that come bundlet) 
w'itli every purchase of your music pioduclion software arc 
worth a combined retail value of $900.00. I hey knew they w'ere 
saving money, but they may not have Ixcn aw'are ihai they 
would he saving that much money! With this iti mind, make sure 
the IxjnLES item you're offering with every purchase is ati 
ap[)ro[)riate sales iiicemive. Including a free t-sliirt {a $I2.CKJ 
value) with the purchase of yt>ur $830,00 ammaiion software 
may noi provide enough motivation for tfiose undecided users. 

Another ptjpular selling iechnit]ue is the bundling of several 
related products into one cost-effective suite or collection. This 
approat^h tends to work well for productivity tmils and games. 
MacTOincdia humlles Dreamweaver, Flash, Fireworks and 
Freehand together in one Studio package. Adolx:'s Creative Suite 
includes Photoshop, Illustrator, InDesign, and other applications. 
Die liook is that tile collection i.s (>fTered at a price that's much 
less than if you were to buy all of those applications 
indivklually. 'lb consumers who are interested in one ur more of 
those products, the bundled .suite appears to be ix.st deal At 
first glance, some developers may disregard this strategy, 
tliinking that the suite cannibalizes individual product sales, but 
they would be wrong. Don't as.sume that someone who 
purchased the Suite would have ordinarily bought each and 
every product at full price if the Suite did not exist. Interested 
consumtirs would have probably purchased only one or two 
products, so they end up spending less than the Suite price. Hut 
since the Suite is such a good deal, they arc willing to spend 
moa" money to save money. This introduces new' users to 
products thew oalinarily w'ould not have purchased, If they 
enjoy using the softw^aa^, they heconic loyal users wTk) end up 
purchasing the next Suite upgmde instead of only uj>grading tlie 
one primar)' prtxluct they use most. In the long am, it's a win- 
win situation for every'onc: cu.stomcrs save money and you nei 
higher profits. 


For a Ltmited Timl Only! 

Ctmsumers who are interested in your sofrw^are, but keep 
putting off the [>urchase for another day wall continue to stall as 
long as there is no rush. Unless they urgently need your 
software for a specific task, diey w ill not be in a hurry' to spend 
their hard-earned money if your special offer or bundled suite 
will alw'ays lie available. Procrastination leads to foiyteifulness, 
so give them a reason to purchase Ixfore their intere.st wanes. 
By placing an expiration date on your special offer, you Ye 
ftrreing those users to make a decisitm within a specific time 
window. The fear of missing a money-saving opportimity i.s a 
powerful purchase incentive. In Figure 2, our fictional 
CodeQuiver web site takes it a step fun her by c’ounting dow-n 
the number of days left to take advantage of the special offer. 
Expcriencetl w^eb site designers can use scripting languages like 
PUP or JavaScript Lo CTcale a dynamic countdown, .so that w ith 
each new^ day. the displayed countdown on your .site 
atitomatically calculates the numlier of days left before the 
special offer end.s. 

If you maintain an opbin e-mail new^sldtcr for 
announcing softw^are new'S to your customers and interested 
users, be sure lo utilize thi.s powerful marketing tool to 
remind subscribers that your special offer will end sexm. Do 
nor assume that people will remember on their own. We all 
lead extremely Imsy lives, so there's nothing wTong with a 
helpful reminder of a money-saving i>t>|H)riuniiy, [ust don't 
beat them over the head with a daily countdown or you may 
see a ret'ord number of people unsubscribing from your e- 
newsletter (or worse: accusing you of e-mail marketing 
abuse). Save the counldown for your wxd> site. If your speeial 
offer lasts iw'o months, then send your subscribers an e-mail 
reminder once a niontli and then t)ne last reminder a week 
before the offer ends. Only send e-mails to iltose people who 
voluntarily subscribed to your e-newsletier. With the new 
U S, strain law' now in effect, developers need to tread 
carefully when promoting softw'arc via c-niail We'll discuss 
the guidelines of the new CAN-SPAM Act and how it affects 
software develotjers in a future column. 

lDE>mFYiNG Value 

We've cxjvered several strategies for **sweetening the 
deal/ but you know' your .software [products and ti.scrs l^cLLcr 
than anyone. Look at customer feedback and feature requests 
for inspiraiion. Devise your own purchase incentives that 
work for your software products, Wlm value do your users 
place on price, free bonus software, choice of features? 
Experiment to find that key factor or combination of 
elements that persuades them tt> buy. If yt>u can motivate 
those holdout users to finally purchase a license (and still 
make a decent profit in the process), then you'll be one step 
ahead of the game with Lite increased revenue needed to 
grow your software business. 
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QUICKTIME 

TOOLKIT 


hy Tim Monroe 

Swing Shift 


Editing QuickTime Movies with Java 


iNTROniICnON 

(n the previous QuickTime Ttxjikii iirticlc of 

Java" in MacTeeb, January 2004), we saw how to use Quiukllme 
for Java to open and display Quick'rime movies in a Java-leased 
application. We saw^ how to use AWT components lo elicit movie 
files from tiie user (al!x.4t indirectly, by a call to the QTFiie methcxl 
standardGetFilePreview) and to display and manage movies in a 
window (using the Frame and QTComponent components). We 
also saw how to dE.sf)lay and handle the applicaiion's menus and 
menu items (using the Menu, Menultem, and Action classes). 

In this article, we Ye going to extend the appltcaiitm we buili 
in the previous artide — called JaVeez — to handle movie 
editing. Well see how to do standard cut, copy, and paste 
editing, and we'II see how to save an edited movie into its 
original file or into a new file. We also need to iniplcjiient the 
stanckird doc:umenl behaviors, sucli as prompting the user to 
.save or discard any changes when an edited movie window is 
about to Ixf closed. In particular, we'll see how lo display and 
manage the ‘'Save Changes" dialog box showm in Figure 1. 


n n O Safflpl^Mcvie.mov 


@oo 

Savt chafes before closing 

A 

Dq yoy want to s*vt tho changes yau made to the document 
'^SampleMovie. mov^ 


(Don^t Save ) f Cancel ) Save j 





Figure 1: The Saw Changes dialog box of JaVeez 

By sheer coincidence, the dialog boxes well use to perform 
these remaining tasks are best displayed using Swing, not AWT. 


The dialog box in Figure 1 can be dLsplayed with a single line 
of code. We get the warning icon essentially For free, by passing 
the appropriate constant. We also get with the standard behavior 
where the Save button is highlighted as the defatilt huiton and is 
activated by hitting the Return tir Enter key on the keyboard. To 
rny kntjwledge, ilY not [jossilde to designate a default button 
when constructing a dialog lx)x using AW f. 

We ll also take a look at handling several of tlie ilems in the 
Mac OS X Application menu. Well see how to display an About 
l)ox when the user chooses the “About JaVeez” menu item, and 
well see how to handle the Quit menu item correctly. We’ll use 
a class inirodured in J2SE 1.4.1 for Mac O.S X, Application, to 
handle tliese operations. This class also makes it easy for us to 
handle ba.sic Apple events, such as the Open Documents event 
that is sent to our application when the user drops .some movie 
files onto the application icon in the Finder. By the end of this 
article, JaVeez will be virtually indistinguishable from the C- 
language Carbon-based application QTSliell ifs modeled upon. 

Movil EorruNG 

irs extremely easy to add support for movie editing to our 
application, becau.se the MovinControEler clas.s in QuickTime for 
Java provide.s |)reUy much all the methods we need. For instance, 
to cut the current movie selection, we can execute the cut 
method on the movie controller object asstK'iated wath a movie 
windtjw. As well .see in a moment, we also need lo place the cut 
segment onto the system .saa)> sc] thal it's available for 
subsequent pasting (either by JaVeez it.self or by any olIilt 
QtiickTIme-.savvy application). 

In order for tliese editing methods to work properly, we 
need to explicitly enable editing. You may recall thai in the 
previous anicle, we executed ilris code in the 
createNewMovieFromFiie methcxl: 

If ((me.aetCantrollecInfo(] & 

StdQTConstants.mcInfoMovielsInteractlveJ = 0) 
i3i[:!.enablaEaitlng(true] ; 

This code looks to see whether the movie is an interactive movie 
(such as a QuickTime VR movie or a Fla.sh movie); if it's 
interactive, it is not editable and therefore we do not w^ant to 


Tim Monroe is a member of the QuickTime engineering team ai Apple. You can contact him at monroc@madech.com. The views expressed here are 
not neceasarily .shared by his employer. 
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enable editing. (If we did try to enable editing on an interactive 
mcwie, an exception would be raised,) 


Handling Editing Operations 

In JaVeez, the user perfonns editing operations using eitlier 
the menu items in the Edit menu or theii standard keytoard 
shortcuts. In either case, one of our action listeners will be 
invoked. For instance, Listing 1 shows our declaration of the 
UndoActionClass, an instance of which is attached as a listener to 
the Undo menu itetn and its kc 7 hoartl equivalent. As you can 
see, we simply call the movie controller's undo method and (hen 
call our own method updateEditedWindow. 


Listing 1; Undoing Ute previous edit ____ 

t 'ndoActionCb&s 

public class tlndoActionClass ftxtends Abstract Action ( 

public tfndoActionClflfijt (String text. Keystroke shortcut) I 
super(text )i 

putValue(ACCELJiKAl'OR_ttEY, shortcut): 

I 

public void actionPerformed (ActiouSveiit ej I 
try ( 

nc.undoO ; 

update£dltedWindov(); 

I catch (QTFxception errj I 
crr.printStackTraceO r 

( 

1 

1 


The updateEditedWindow method performs any openitions 
that might be required wlien lliaL the movie in the specified 
frame has been altered by an edit operation. For instant:e, the 
size of the movie may have changed, so we ll want to call our 
methtxl sizeWindowToMovie to ensure that the movie window is 
sized to exactly contain the movie and tlic movie controller bar 
(if it's visible). Also, we’ll want to adjust the items in the File and 
Edit menus appropriately. Listing 2 shows the 
updateEditedWindow method. 

listing 2: Updating the state <if an edited window 

updaicIiditcdVUnilow 

pvibt tc void UpdateEditedWindow () ( 
try I 

Bic. QiovieChauged (): 
me.movieEdited 0; 
me.controllersizeChangad{1 ; 
ad.iusthenuIteinKO i 
sizeWlndowToMovteO : 

I catch (QTRxccption err) ( 
errtprlntSLuckTruceO ; 

I 

1 


The actions assoc iated with pasting and clearing can be 
handled by code that's exactly analogous to that in Listing 1 
(just change "undo** to "paste" or '"clear in the actionPerformed 
metliod). In the two remaining cases, cutting and copying, we 
also need to make sure to move the cut or copied segment to 
the scrap, by calling the putOnScrap metliod. Listing 3 gives cmr 
implementaiion of the cut operation, llie movie controller's cut 
method returns a QuickTiine movie that holds the segment cut 
from the movie in the window; we copy it lo the scrap and then 
disptisc of that movie segment by calling disposeQTObject, 


Listing 3: Cutting the movie selectlQLia_ 

CutActioftdass 

public class CutActionClass extends AbstractAcCion ( 

public CutActionClass (String text* Keystroke sboxteut) 

I 

super(text); 

putValue(ACCELiijlATOH_ltEY, shortcut): 

I 

public void actionPerformed {ActionEveut e) I 
try ( 

Movie edixMovie ^ mc.cutO: 
editMovie.putOnScrap(0 )\ 
edltMovle.disposeQTObjecl{): 
lipda t cEditedWindow 0 i 
I catch (QTException err) ( 
err.prlutStackTraceO : 

) 

f 


Our action handler for the copy operation is even siiiqiler, since 
wc don’t need lo call updateEditedWindovv (because copying die 
current selection from a movie docs not change the original 
movie). 


Selecting AH or None of a Movie 

As usual, our Edit menu comaiiis two further items, 
"Select Air and ‘"Select None", which are quite easy to 
implement. In earlier articles, we've seen how to handle these 
items by calling MCDoAction with the 
mcActionSetSelectionOuration selector. Listing 4 shows how 
JaVeez handles the *" 8010(1 AlU command, 

Listing 4: Selecting all of a movie __ 

SclectAllActionQa.ss 

public class SelectAliActionClass extends AbetractActIon I 
public SeiectAllActionClass (String text. 

KeySiroke shortcut) [ 

super(text ): 

pu tVa t u e{ACCELERATOR_KEY, short cut): 

] 

public void uctionPerfomed (ActionEvent e) I 
try I 

TiroeRecord tt “ nev TiiiiJeRecorcl(oi,getTiiaeScnle{), 0); 

nc.setSelectlonBeglnttr); 
tr .setValue(ni.fictDucatlon()): 
me.seiSelectionOuratlou(tr)r 
I catch (QTException err) I 
erc.printStackTraceO ; 

] 

I 

1 


llie interesting tiling here is Lhai a TimeRecord is an object 
(which must be explicitly constructed l>y a call to new), not a 
structure its in our C code. In general, Java does not support 
either struct or union; instead, we need to build these sorts of 
composite types using classes or interfaces. Tlie package 
quicktime.std.ciocks provides access to TimeRecord objects and 
die inediods to get and set their propenies. 

Listing 5 shows how' JaVeez handles die “5ielect None" 
command. 


Listing 5: Sel ecting none of a movie ___ 

SclectNoneActioaClass 

public class S^lectNoTieActlonClass extends AbstraciAcirion [ 
public SelectKoneActionClaas [String text. 


FtEBRL'ARY 2004 • MaCTeCH 


SwiNG Shifi' 


59 










Keystroke shortcut) \ 

super(text); 

put Value (AC CEL£RATOR:_KEY, shortcut); 

* 

public void actionPerfontted (ActionEvent e} I 
try I 

TineRecord tr * new TlmeKecordCm-getTiiaeScaleO ^ 0); 

mc^setSelectlonDurationttr): 

) catch (QTExceptlou err) I 
err .printStackTraceO ; 

1 

J 

1 


Enabling and Disabling Menu Items 

Fdiling a movie usually entails tliat some of the items In the 
Edit and File menus need to be adjusted. For instance, culling a 
segment out of a movie should lx* undt>a[)k\ so we want to make 
sure that the Undo menu item is enabled. Similarly, once we’ve 
made any edit operation whatsoever to a movie, we want to make 
sure that the Save menu item is enabled. Listing 6 shows our 
implementation of the adjustMenullems method. Notice chat w^e 
disalrle the entire Edit menu if editing Ls not enabled for the movie. 
Also, we am use a movie's hasCbanged method to detennine 
whether to enable or disable ihe Save and Undo menu items. (As 
you would guess, we clear the movies changed state — by calling 
the clearChanged method — when the user saves a movie.) 


liandling the Close and Quit items, we need to check to see 
whether the user has made any changes lo the frontmost movie 
window or to any of the open movie windows. If so, we need 
to give the user an opportunity to save or discard those changes. 
We also need to allow the user tcj cancel the close or quit 
operation altogether. 

Closing a Movie Window 

We can do all this by adding a window aclaptet^ to our 
application. A window adapter is an object that listens for 
specific events involving a window and executes a method 
when it receives a notifitiation that one of those events has 
Qccurrtxl Currently, we can listen for window aaivation or 
deactivation, iconificarion or deiconification, and opening or 
closing, lliere are two flavors of window closing events; we can 
be notified that a window ts in the process of Ixing clased, or 
we can i>e notdled that a window actually has closed. Clearly, 
we want to listen for the First kind of windfw closing event so 
tliai we can cancel it if necessary. 

We ll define a class that extends the WindowAdapter clas.s; 
this means that our class needs to implement some but not 
necessarily all of the methods in the WindowAdapter class. As just 
mentitjned, we want to implement only the windowClosing 
millKxI. listing 7 shows our definition of the WindowAdpt class. 


Listing 6: Adjusting the menu items 

public void adjustHenuTtema () 1 
try f 

if £ tmc.getControllerlnfoO & 

S t d QTCo tiST ants. me 1 af oKd i 11 iigEaa bled) 
editManu.£atEaabi€d(false): 
else 

cdit He nu,se tEn abIed(t r ue); 


:id}iLSiMcnLiltc]us 


0) 


if {tn. has Changed O) [ 

niiSav€,s€t£nablsd(irue) i 
lalUndo.eutEnabledttrue); 

} else [ 

miSave.setEnabledtfalse): 
nlUndo,setEnabledtfalse): 

] 


if !»c,getVi0ibleC)) 

piSh 0 wCon troller.seiLabe1 

(resBundle, getStringP'hldcControl lerTtem**)); 

elsa 

BiiShowCont roller. setLabel 

{resBundle, aetString(“showConti:ollerltera")) i 

] catch tQTException err) t 
err,prlnlStackTracoO ; 

1 


It’s worth remarking that this menu-enabling logic is tjuile a 
bit simpler than that contained in our C-language ap])lications, 
primarily because in JaVeez, a menu is always associated w'ith a 
movie window. This means that the Close and “.Save As.., items 
should always be enabled. 

File Manipltiation 

Now let’s consider how to liandle the Close and “Save A,s..." 
menu items, along with the Save and Quit menu items. When 


Listing 7: Handling a request to close a window 

windowQobini; 

class WitidowAdpi extends J ava. ?iut . event .WindowAdapter I 

public void windowClosln^ {java,awt.event.WLadevEvent event) I 
try I 

if (m.hasChanged()) 

asks a veCh an ge s (r es Bu n d le. ge i S t r 1 n g (" c 1 OfiuTcxt "^)): 
else 

d UpoiseO ; 

t catch (QTExceptlon err) t 
err.priruStackTracoO : 

( 

I 

1 


This is simple enough: if the movie in the window Iia,s changed 
,since it was opened or last saved, ask tlie user lo save or discard 
ihose clianges; olherwi,se, call dispose lo clo,se the window. (The 
dispose method is implemented by AWT’s Window class.) 

In the JaVeez constructon we creaie an instance of this class 
and ,sci ii as ihe windtjw ILsiencr like ihis: 

WindowAdpt WAdapter - new WindowAdpt(}; 
addWlndowListener(WAdapter): 

All thai remains is to write the askSaveChanges melhod, 
Thi.s meiliod needs to display the Save (Changes tiialog Ikjx (see 
Figure 1 again) and respond to the user's .selecting one of the 
three buttons in that box. Happily, Swing provides the 
JOptionPane clavS.s that is tailor-made tor this purpose. Listing 8 
shows our implementation of askSaveChanges. We pass in a 
siring objeci that indicates whether the user is dosing a 
particular window^ or quitting the application. 
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See Dick. See Dick run his business 
with software that wasn’t written 
and designed for his Macintosh. 

Poor Dick. 


A inamcnt of silence for Dick, please. A good 
guy with a good smalt business^ bui his accountirjg 
software was one of those PC transcription jobs, 
nor pure MAC like MYOB AccountEdge and 
MYOB FirstEdge. 

If only he'd known about die ainazhig capacity of MYOB 
software to bring out the best in liis MAC operaring system. 

He could have tracked and managed finances at a glance or generated all the 


reports, invoices, and tax documents that he and his accountant would 
ever need. He could have spent more time with his clients. 
If he had only known that MYOB develops the worlds 
best selling MAC small business management 
software for lots of good reasons, this srory 
might have had a happy ending. Sorry Dick. 

MYOB, 

THE MAC ANSWER. 

®2cnr!! MYPlf US, Inc www,m.y(^b.com/ui 




























Lilting 8: Prompting the us er to sa ve a chan ged movie 

askJavcOungcs 

public booleaQ askSaveChanges (String actionString) [ 

Object[] options “ I“Save". “Cancel", “l>0n\uOOA9t Save"!: 
boolean tfindowCloaed ~ falsa: 

lot result JOptlonPanepShovOptionDlaiog(this, 

“Do you want to save the changes you roade 
+ " to the document" 

+ "VnVuZOlC" + baseName + “AU201D?", 

“Save changes before “ + actionString, 
JOptionPane.YE£_NO_CANCEL_OPTTON* 

JOptionPane. WAMING J1ESSAGE* 

null, 

options* 

options [0]): 

if (result “ SAVE^kEStJLTJ f 
// save the diangeij and ebse the win<li>w 
saveO ; 

windowClosed - true: 

) eUv if (result -= CANCEL_RESDLT) \ 
a don't save changoi and don't dose the window 
windowClosed ” false: 

I else if (result =* DONTSAVE^RESULT) t 
// don't save changes but do close the window 
windowClosed * true: 


if (windowClosed} 
disposed ; 


The Uniccxle value “\uOOA9" gives us the nicer-kx^king ap<xstrophe 
in ihc word "’Don’t", and the values ‘‘\u201C" and "‘\u20tD" give ys 
the nicer-looking quota lion marks around the filename (though 
it's bard to tell dial in die font used in this dialog bcix), 

Saytng a Changed Movie 

The askSaveChanges mediod (listing 8) calls JaVeez' save 
method if the user elects to save the changes to the window. It's 
easy to implement that mcLhtKl, using the movie's 
updateResource mediod. listing 9 shows our save methcxl. 

listing 9 ; Savii^ a movie_ _ 

save 

public void save {) I 
try I 

If (curf ™ null) ( 

SaveAsC] : 

I else I 

m .updateResource{omf * 

StdQTConsrsntfE^Eiovl elnDataForkResID* null): 
iD.clearCbangedt): 

) 

I catch (QTException err) t 
err,prinT.StackTrace{): 

1 

1 


return(windowClosed1; 
I 


The showOptionDialog method returns the index in the 
options array of die selected burton. jaVee?: defines these 
constants to make our code easier to read: 

private static final int SAVE_RESULT “ 0: 

private static final Int CANCKb.RESULT = 1: 

private static final int DONTSAVB^RESIFT.T - 2; 

Wlien it exiLs, the askSaveChanges method returns a boolean 

value ihat indicates whether it actually closed die window ii was 
asked to close. Our windowClosing override melliod ignores that 
value* but well need to use it when we call askSaveChanges during 
the pnx:ess of quitting the application. More on dial later. 

One final point: what's with the gibberish in a couple of the 
strings in askSaveChanges? Strings in Java are Unicode strings, 
and using the standard keylxiard entries for the aposinjphe and 
the left and right double quotation marks would yield a less 
satisfactory dialog box. Compare Figure 1 to Figure 2: 



A O 

son 

channel btforE dtifii^ 


i 

Da you wim to itvt tiH yovi mod# to fhf doctinwnt 

! 

! 

1 0 «i 1 Sm ) ( Cmcc) ) f Sw* ^ 1 


1 y Dll. 1 ! 

1 1 




figure 2: The Saw Changes dialog box 
of JaVeez (bad characters) 


If no movie file is yet ass<x:iaicd with the movie window, we call 
the saveAs meihcMi instead of updateResource. This has the effect 
of displaying die file-saving dialog Ixjx, wliicli allows the user to 
specify a filename for ihe tnovie. 

Saving a Movie bito a New FiJe 

When the user selects the “Save As** *" menu item in the File 
menu (or, as we jusi saw, elects to save a movie that has not yet 
been asstKnaied with a movie file), we need to elicit a location 
for the new movie file and then save the movie into that file. In 
JaVeez, well execute this line of code: 

fd = new FileDisIogEthis. "Save: JaVeez"* F11eDialog,SAVB): 

The AWT FileDralog class, when passed the FileDialog.SAVE 
parameter, displays a dialog box like the one sfiown in Figure 5, 


0 00 S*yt:JaV*« 



Figure 5*' Ihe file-saving dialog h(jx displayed byfAVCf 
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At PR Newswire, our approach to distributing technology news is simple: target the 
people with a real interest in your news - journalists, investors, analysts and consumers - 
and deliver your message to them in the way they prefer. 
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This is one of the few cjifies wliere the AW*r dialog hox is 
preferable lo ihe corresponding Swing dialog box, wliich is 
shown in Figure 4 

e Save 



Figure 4: T7.w Jtie-$avin^ diakig box dL^)kiyad hy Suing 


As you can see, the AWT box niorc closely resembles the native 
file-saving dialog box displayed by Carbon or Cocoa 
applications running on Mac OS X, 

Once the user has .selected a new location and file name, 
we can save ilie movie into that file by executing ihe flatten 
meihcKl on the movie, as shown in listing 10. 


Listing 10: Saving a movie into a new file 

sjiwAs 

public void saveAs 1} 1 
try 1 

If ffd — null) 

ftl ^ nnw Fi leDlalogtthis* "^Save: JsVeez*. 

Filcaialo^.SAVK): 

fd. setFilc (null): //dcunml the file name 
fd.showO: 

String dirHame = fd .getMrectoryt 1 1 
String flleNatne fd.getFileO : 

If t(difNaai(» null) && (fileName 1“ null)) t 
qTFUe (Jtf » new QTFHe(fiirNata^ + fileNuoivh 

m. flattit 

StdQTConBtants.flattanForccKovlnReaourceB^foreHnvleData. 
qtf. 

StdQTConstants,kMoviePlaye r, 

TOConstants. stnSystemScript, 

St dQTConstantfl.c reateMuvleFiieDelet eCu r P11o, 

SldQTCon atanta,movieInDataPo r kResID. 

qtf *gelNiii£ieO}; 

// chMic Uic ixijinLCtJon m ilu- irurrcm movie fik 
if (aiif J- null) I 
onif .cloeeC ): 
omf - null; 

) 

// now open the new file in the airrcnt window 
createNewHovieFromFiletqtf.gptPath()^ true); 

I 

1 catch {QTEnceptioti orr) I 

if (err.errorCodeO Errors,userCancelodBrrJ 
err,jjriritSiackTracoO ; 

I 

1 


The standard l:tehavior of a “Save As.,ojFcration is that the 
new movie will replace the existing movie in the existing movie 
window. Accordingly, saveAs closes the connection lo the 
existing movie file (by calling its close mciiKxj) and calls 
createNewMovieFromFile with the full pathname of the new 
movie file. By pa^ising true as the second parameter, w^e instruct 
createNewMovieFromFile nt>t to reposition the window. 


Quitting the Application 

When the user decides to quit JaVeez (typtcally by selecting 
the Quit item in the Application menu or — on Windows — the 
Exit Item in the File menu), we want to loop tiirough all open 
movie windows and call the askSaveChanges method on each 
window that’s been edited since h was opened or last saved. To 
my knowledge, AWT does not provide a way to find just the 
open movie windows. It does provide the gelFrames method in 
the Frame class, but my experience is that ihe army rciurned by 
getFrames includes an entry for all frames ever created by die 
application (not just the ones that are currently open and 
visible). Nonetheless, we c^an use the getFrames method to gotxl 
effect by simply ignoring any frames ihai are not visible or do 
not belong to the JaVeez class. Listing 11 shows our 
implementation of attemptQuit. 


Listing 11: Handling a request to quit the application 

aitcmptQuit 

publir boolesn attsnspiQuit () I 
// ify to ck>se iill upun diicumcnt wiuditws; if nfinu i.s kcpi (ip<;n.quit 
Ftonie[] frames “ Frame.getFrames(): 
boolean dldClosc = true; 

String qultString “ resBundle.gutString{"quitText“): 

// Iry aJt open lauvk; windows other tluin (hi* funrcni one 
for tint i = 0; i < frameu.longth; J++) 1 

if ((fratneElil this) tframeullj 1” oull) && 

(frames f i] .getCXassO tgetNumeO “ ‘■JaVeez*'} 

(f runes Ml-ifiVislbleO)) i 
try I 

JaVeez Jvz * (JaVeez)tframes 11]): 

if Ejvz ^ null) 
continue: 

tf (jvz.isDirty£)) 

didClose ^ jvz,askSaveChangea{quitSLring); 

if (NldCloso) 
return(false); 

I catch (Exception ert) I 
err.printStackTrace £); 

I 

I 

1 

if (this.isDiriy()) 

didClose = this,askSaveGhangos(quiTString3; 

If ididClose) 
goAway(): 

return(didClose): 

I 

YouTl notice that wc postpone handling the fcnmiost 
window until all other movie windows have been handled. 1 
suspect iFs not a good thing lo dispose of an object w^hile it’s 
still executing one of its methods. 
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If nom of the open movie windows has Ix^cn edited or the 
user does not cancel ihe closing of any c^f them, then atlemptQuil 
exec'utes the goAway nicdi<xJ. This method simply closes die 
applioaiion's conneaion to QuickTime and then exits (listing 12). 

listing 12: Quitting the application 

gciAway 

public void goAvay (1 I 
try I 

if (qtc null) 

qtc,sc(.novieController (null): 

I raieh (QTExceptlon err) ( 

I 

ClTSession*close{): 

System.exit(0); 

I 

Appucation Objfcts 

Let's finish up by considering how to integrate our application 
with the native Mac OS X operaiing enviromneni so tliai it am us 
much xs possible like a welLwritten C'arlxin or Ctx'oa a[5j)lioation. 
Java 1,4J for Mac OS X includes die new package com.apple.eawt, 
which contains the Application class, lliis class provides methcxls 
that allow us to fmc-tune the appearance and l>eliavk>r of the 
Application menu, respond to items in that menu, and handle the 
Ixisk: application-related Apple evems. By cieating an upplicaiion 
object and aitacliing to it an al^ication listener, we can (ft>r 
instance) resjxind appropriately when the user drags some movie 
files onto our application's icon in ilic Pindex 

To take advantage of these enhancements, we need to 
impon the apprt>priate packages: 

impon com^appie.eavt. *: 


Creaiiiig an Application Object 

YduII recall fixmi the previous article that JaVeez dcclaR?s 
tfu: suific variable fApplication: 

private fltatJc Application fApplication ^ null; 

In its ct>nstrutior method, JaVeez calls the createApplicationOfoject 
method, which is definetl in Listing 15. After ensuring that 
fApplication ha.sn’t already l>een set to u non-null value and that 
the application is running on Mae OS X, createApplicationObject 
retrieves the applit:aticm object, disables die Preference menu 
item, and installs an application listener. The Li.stener implements 
meihods that handle some of the items in the Application menu 
(Alwul, Preferences, and Quit); these methods are also called 
when certain Apple events are targeted at the application. 

Listing 13: Creating an Application object 

citrJirtAppIk'atioQObjtcl 

pubtc void createAppilcationOhjBct 0 ( 
ir (Cf Application ** null) tth 

QTSession, 1 sCu r r en t OS (QTSesa 1 on. kHacOSX))) [ 
fApplication “ Application.getApplicationO: 
f Ap plicat ion. sot Rn a bl e d P r <? f e r en c esHen u f f a 1 se); 
fApplirsrIon.addApplicationListener Cnaw 
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CDiB. apple. iAppli^Ht ion Ada pier 0 I 

public void handlcAbout (ApplicationEvetit e) t 
about {}; 

e.setHandltd(true): 


public void bandleOpenAppiication (ApplicatlonEveut e] ( 
I 

public void handleOpenFile (ApplicationEvent e) I 
launchedFromDrop true: 

JaVeez jvz “ new JaVeez(e.getFnonaine(l); 
Jvz,CreuteKe¥HovieFrotiiFile{e*gctFilenaine()» false) ; 

J V7. , toFront (}: 


public void haudlePrcferences (ApplicationEvent e) i 
preferenceaO ; 
a.aetHandlad(true): 


public void handlePrintFiie (ApplicationEvent e) I 
] 

public void handleQuit (ApplicationEvent e) I 
boolean ailWindowsClosed: 


Showing the About Box 

We have to tackle one final task, namely displaying our 
applinition's Alx>ut Ik)X. We want this lo Itx^k as much as 
possible like the About lx>x of QTShell, shown tn Figure 6. 


About QTSbell 

i 


A QuickTime movie player. 

i 


Written by the QuickTime Team 



€>2000 Apple Computer, Inc, 





Figure 6: We About h^iX of Ql^beil 


allWindowsClosed “ attenptQiilt(): 
c.actHandled(allWindowaClosed); 

ni 

) 

I 


Once again* Swing provides a ridiculously easy way to do this, 
using the JOptionPane class fwliich we used earlier to display the 
“Save Changes'* dialog box), Here, we want lo use the 
showMessageDialog metliod, as shown in Listing 14* 


These liandlers can call the setHandlnd meihod to indicate 
whether the event was handled. The m{)st inleresiing case is the 
handleQuit method, which (as you can see) returns the value ii 
gets from the atlemptQuit jnethod. Hiis allows our application lo 
prevent ilself from quitting if the user cancels ihe suve-or- 
di,scard<'hanges query. 

Handling Dragged Files 

In Older for the user to lie able to dnjp QuickTime movie files 
onto our application s icon, we need to set the document ly[K^ 
supported hy JaVec?*. We do this by seleaing ilieJaVeez laigel in 
llie project window and then chcxjsing the “Get Info" item in the 
Project menu* Click the "+** button at the lower-leti corner of the 
Into window' lo add the desired file types. As you can see in 
Figure 5, jaVeez .supports Quic kTime movie Hies and I'lash files. 


Ltisting 14: Displaying the application About box 

about 

public vcid about 0 \ 

Ima^elcon peugululcon • now Ttuagelcon 

(JaVeez.clasu. gotEeBOurce(*peTtguin, ): 

JOpt 1 ouPane. showHessageDlalog([Cocnpoitont)null, 

''A QuiekTiiuo laovie playor appHcatioti'* 

+ **\iibul]t with QuickTime fur Java, \n \ii'* 

+ ''\uO0A920O3 by Tim Kottroe", 

"About iaVrjfiz". 

JtJptionParif?* FNTDRJlATTaM HESSAGE. 
pt^nguinlcou): 

1 


When w'e call the about meiht>d, showMessageDialog 
displays the dialog box shown in Figure 7. *rhis is remarkably 
€U>se to The target AIkhU Ixix show'o in Figure 6, 



Figure 5* Ihe supported document Oyxcv 


@ o o 


About JaV€ez 



A QuickTime movie player application 
built with QuickTime for Java, 


O200S by Tim Monroe 




jFigiire 7: Ihe Almut bK^ofJaVeez 

llie parameters passed to showMessageDialog should Ik* 
fairly obvious. The first parameter Is the parent frame; in this 
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rj;se we pass null so that the message pane is emfxrdtled in a 
default frame that is centered on the main screen* Tlic second 
parameter is tlic message string; notice that we can enilied the 
newline esc'ape chanicter into the message string, as well as 
tile escape setpienee "\uOOA9" (w^hicli is the Unicode value of the 
copyright symbol *‘0”). The third parameter is the title of the 
enclosing frame. The fourth [larameier is ignored since we are 
passing an icon as the fifth parameter. Here we are using the 
sUmdartl [xmguin image, which we added to our project. We 
need to call the getResource meihcxi lo load that image from the 
applicatkm bundle. 


CONClXIStON 

In this anicie, we've seen how to exteiul the basic java 
application we btiilt last time to handle movie editing and 
document-related operalions. Tht Movie and MovieController 
classes in yiiickTime for Java pit wide nearly ail the methcxls we 
need to handle these tasks. And the Application class adderi in 
J2SE L l.l for Mac OS X makes it panicuhirly easy to open files 
dropped onto the application icon, display an About Ixxx, and 
handle application quirting. 

jaVeez is now pretty much feature-complete. You may l>e 
puzzled, however, that weVe ftxused almost entirely on 
building an application tailored for Mac OS X. After all, a large 
part t)f the allure of using Java to build applications and appieLs 
is their ability to run unchanged on multiple platforms. Clhe Java 
programmer's mantra is of course "write cmee, rim anywhere”*) 
So what alxHit Windows;* Will JaVeez run uncfiangetl on 
Windows computers timt have Quic kTime installed? In a word: 
no. but the changes required \o gel JaVeez to nin on Window.s 
are indeed tgiite minimal We’ll take a look at those changes, 
and perhaps also at a few simple enhancements to JaVeez, in tlie 
next article. 
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REVIEWS 


Hy Guyren G. Howe 

REALbasic Review 


A better Visual Basic than Visual Basic 


I always figured thar my plans for world domination hinged 
on Ixnng able to quickly write great, easily maintained programs 
on all ihe major platforms, t also need my less experienced 
minions to easily learn to do the same. 

Quake in fear, for RKALbasic may lie just what fm 
l<K)king for 

In tins review^ fm going to give you a detailed it)ur of 
REALbasic, pointing out the interesting features of the language, 
the IDE, the debtigger, the comfKmy and the community 
(liecaiise Uie latter are also very important to the value c)f a 
programming language). My aim will be ifjal ljy the end, 
whatever your needs, you'll have a gocxl idea whether 
RKALbasic wall help you to fill them. 

rm going lo mix up talking about the existing %2 release 
and what looks likely to make ii into the 5.S rek^tse. Em doing 
this I'lecause REALbasic is devek?)>ed at a snappy pace — a new 
version every six months — and beaiuse some of the 
inifK'nding features might well be import ant to you. Contrasting 
the two releases will also give you an idea of Ik)W quickly the 
protluci is improving. 


Bfoimnfr friendly 

Some of what folk)WS will Ik- a bit technical, st> I w'anied to 
pul this right up front: RKALbasic is excellent tor Ix^ginners. If 
you're a beginning pR)grjmmer just wanting to knock together 
some ‘*biLsic” programs, REALbasic has that covered. If yoti’re 
looking to leam programming, REALbasic is very acc essible, and 
you can gradually ramp up to using more sophisticated 
techniques once you're ready for them. 

If you are interested in using HilAIJ^asic as a vehk'te for 
learning to program, or if you have never taken a lull computer 
science course and you'd like to improve your programming 
skills, check out the Cuniailam Pivject that I wrote for 
REALbasic. Ifs a gocxl basic computer scienc’e curriciiluni in 
thirty lessons, available from the RKALI>a,sic website 
(www,realba5icxom). 


Documentation 

A really impoitum thing right out of the Im>x: the REALbasic 
documentation is actually fairly good, and certuinl)'^ better than 
fve seen lor many programming ttXjLs. 

There is a built-in refcrene'e that's almost always accurate and 
sufficient — once you get up to .specxl, iliis is mostly what you'll 
refer to. There are also a Qukk Skffi and Tutorktl, which are hne 
as far as they go, which isn’t very tar. 'lliere's a Usir's (a 
quite good, more extensive and useful introduction) and a 
Re/eremv (a j)rintal>lc version of the built-in help), 
Tliere are also a bunch of smaller ReudMe Files on such things as 
datalxLse and Internet capabilities, 'fhese are concise and accurate, 
ixu far too short. Quite a few of liicse subjects, (anti other subjects 
that for some rea^m don't even earn a README, ,snch as 3D 
graphics), could do with extensive guides in their own right. 

A Fun Dfveldfmfni Environment 

Tile Integrated l^evelopment Environment in REA[J>asic is 
tjuile effective. Not the world's most glamorous, l>ut it strikes a 
nice balance Ixiwecn simplicity and jxiwer. Figure 1 shows the 
il)E in action. 



Figure 1: The REALbasic lufegraied 
Deudofimeut Emiwnment in act it m 


Cuyain G. Howe works in artificial Intelfigence research, after years of w{>rk ns a let hnical writer and developer. He Ls married w iili one civild, i.s an 
Australian, and lives in Austin, Texiis. Guyren lias l>eeri working witli REAUiasic for several years. Most ruaahiy, he wmile the REALbasic Curriculuiii 
Project, an extensive cf>mputer science curriculum, for REAL Software. 
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This Ls at l6(X)xl2fX), hut if can get a little crowded on 
my O' FowcrBook's screciL On tlie other hand, tVe never seen a 
development environment that didn’t (okay, odier dian Etmics..X 
Most of die action will take place in the window editor and 
the cxxle editing windows. 

A nice code editor 

Tile code editing window isn’t the fanciest IVe seen, hut it 
gets the job done without fuss i Figure 2 
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Hj*ure 2: Ihe Code Editor in action 


You get one code editing windiiw per 
eiass/window/mcxlule, combining a simple inspector for ail the 
attributes of diat diing on the left, witfi the asstx'tatetl crxle editor 
on the riglit. Ilie ctxle editor provides comprehensive key^word 
completion (picking up declarations as they are tmde, and 
projx^rly respecting scope), automatic coloring and indentatitin, 
along with gobs of little niceties like fairly comprehensive 
contextual menus, window splitting, and universal drag and 
drop. 1 Ond the relatively spare and iincluitered interface 
refreshing compared to numy olliers — liave you kK)ked at the 
Visual basic IDK recently/ Ifgh. 


A fine window editor 

REALbasic clearly tries hard to help you create a full-blown 
user interface* li has a great windf>w editor that uses autontatic 
snapping according to Apple’s User Interface Guideiines 
(snapping to distance between controls, distance from window 
txlges, and to the center lines of the window') to make user 
interface design almost effonless. Figure 3 shows REAlJ:)asic’s 
comprehensive collection of user interface w'idgeis. 



Figure 3: KtAUume's user interface toolkit 


Tile most interesting widgets here are (top to bottom); 

• a Placard control, specifically for building the little 
inforrnation panel to the left of the horizontal scroll bar in a 
window (actually quite a nice contnlxaion to making an 
effective user interface easy to throw togellier); 

• a BemiButton control, used for making the kinds of new¬ 
fangled buttons all tlie kids are using these' days, combining 
any or all of text, pictures and [X>|>uf) menus; 

• a fairly sophisticated spreadsheet-like ListBox control; 

• a ccxrl 2D animation SfmieSurfuce i'onirol; 

• an even cooler RbBD^ce control, able to employ a preUy 
healthy set of OpenGL 3f> graphics features; 

• a QuickTime movie player; 

■ Windows OLE container supfxm (for Windows applications, 
of which more l^elow); 

• Mae OS X i(x>lbar and altencbrnt buttons; 

• a couple of widgets dial take a little of llie pain out of doing 
database interfaces (more l>elow); 
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* d QuickTime music player; and 

• Contextual menus. 

As well as the user interface contiols, ilEALbasic lets you 
fairly easily create OS X sheets, drawers and even Apple’s new, 
hideous metal windows, alonjr witli the fuU complement of (in 
many cases, even more liideous) OS 9 window styles. 

Oh, and there’s a nice menu designer and a very nice event- 
and class-based way of managing menus, wlikh let you either 
c'enmtlii^e tlie menu activation and handling, or distribute the 
handling around whatever points in the program you feel is 
appropriate. A good example of the nuiiierous sweet design 
choices that make REALI)asic eititer very beginner-friendly and 
straiglitforward, or surprisingly deep and powerful, depending 
on how you use it. 

All in all, REAUiasic couldn’t do a whole lot more to help 
you to create a .slick user interface. 

Project manager 

REAL Software is testing a major new^ feature in S.S: the 
REALbasic Project Manager, 'fhis is a simple server to 
synchronize the work multiple developers. It provides 
accounts for mulHplc tievelopers, and a simple check-out/check- 
in/.synchronize capability for kKiil copies of a project. It's a 
welcome feature, and I hope they continue to develop ii with 
such features as liLsiory and rollbacks. Ii wtsuld also be nice if 
the check-out/check-in sy.stcui offered an alternative CKi’-style 
differencing model as an option. 

VisiTAi. Bask: + Java OujEcrr Model + Ceeaiive ruiNKiNC = 

Good 

REALbasic draws heavily on Visual Fkisic, to the extern that 
jtHAI. .Strftware supplies a free Visual Basic ctHiverter^ a jiroject 
ccinverted from Visual Basic wall still need .some work before it's 
functional. Injt much of the code in a typical Vi.sual Basic 
application will work exactly the same in REALbasic. Eve heard 
of a few cjuile coni|)lex VT3 t)rt}jec1s converted to Rl'ALhastc in 
just a few days. 

The Visual Basic language (Vrsiial Basic was lK>uglU, not 
invenledn by Micnwofl, l>y ilie way) is a generic, (riendly, 
prediclabic, structured programming language. Having this 
language at Its heart, REALbasic nicely satisfies the Imiidpie of 
least suf^}rLse — tilings mostly just w()rk tlie way it seetiis they 
ought lo. Here's a hLihble-,sort algorithm: 

A hihWi' um in RFAlhusic 

The liviiri uf RrAUwiic is Uic VisuuJ Bask lanjjuags: — a nitc.iicncrk sinjnunrd 
pr(){;rammLn^ languuf;c 
//.Snrt n list using a BubbleSort* 
t>ipn Done As Boolean 
Diji Couiiier, Tetip* Limit As Integer 

Limit ^ UBound(Numbers) 

Do 

Done = True 

For Counter 0 To Limit * 1 

if Numberfl(Counter)>Himbei:s(Coiinter + 1) Then 
Temp “ Numbers (Counter) 

Numbers{Counter) ^ Numbers(Counter + I) 

Numbers(Counter + 1) ^ Temp 


Dona = False 
Knd If 

Next 

Limit ^ liini t 1 
Loop Until Done 

But REALbasic’s prognimming langtiage is far from being a 
slavish copy of Visual Basic, The language extends Visual Basic 
inkj a grown-up objc'ct-oriented programming htnguage, mostly 
by adopting the single-inheritance-plus-interfaces 0(TI^ 
pamdigm of the likes of Java* 

Mzijor Language Features 

• Traditional method overriding, REALbasic aj.so su[>poiis a 
novel and marvek)iis class exiension mechanism allied 
Ewnts (rnore on tliat Ixdow); 

• Single inheritance, with interfaces; 

• Metlxxl and cjpennor overloading; 

• Simple compiler conditionaLs (sti you can compile, say, 
diflcTcnit ctxle for different platforms* There are no macros, 
though); 

• Robust, typed exceptitins with a full tn^-catch-fimUynmei try^ 
bltKk (added in S.5 — earlier releases rtnly had exception 
catching at the end of a mellKxi); 

• Conipreheosive safety c'hecking (array out of ix>imds, nil 
variable dcRderence, and so on), with the ability to disable 
any of the safety checks in particular parts of the code, for 
speed; 

• "Bare'' methods and pioperiies (having gkibal scope, and not 
l>eing part of a class); 

• Simple namespaces (in 5,5); 

• Pubhc/Rrtitecieti/Privaie scoj^e (ex[landed in 5-5 from 
l^uhlic/Proteded) for mctliods and [properties; 

• Sc‘[>arate scalars and objecLs, as in Java (many would 
consider this a mis-feature) — and nt> sign of auio-lK)xing 
(aulomaLit: conversion of scalars to objects and Ipack); 

• A complete set of ba*sic math operations, including bit 
Qpertitions, and even quaternions (no complex numlxNis, 
though -- the {juaiernions are [irovided for 3D math); 

• Tlic aliility to define your own ipindings" for classes, that 
support connecting ofpjetts together in the user interface by 
just dragging a line Ix-lwecn ihem, much as you can in 
Atiple’s OItject Builder; 

• "Getter” and "Setter” methods invoked through direct 
property access .syntax; 

• Lneniiy-tyjK-d (gtK)d) automatically ty|X'-converted (had) 
vatiauts, just like in Visual Ba.sic, 

Consptaiou.sly ab.seni from tlie list are any real 
introspection features, serious nuKlularity support, or classes as 
first-class objec^s in their own right, with their own methods, 
properties and events. Tliese are significant omissioas from an 
otherwise robust objcet-orienled (Programming language. 

Inheritance clone different and done right 

There are one (jr two ways in which REALbasic’s designers 
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hnve l>een pmpiircd u> dt^vclup creative new contributioas to 
RFAlbasic\s proj^ramming paradigm. One m particular, which 
goes by the everyday nante of Efferits, is a marvelous idea iliat 
tVe never seen in any <)ther programming language. I'm going 
to unpack this for you, because it's an importani language 
feature you won’t he familiar with, and bet^ause 1 think tnore 
programmers should see this idea. 

KvenLs in REALbasic provide a topnJown class extension 
nuKlel, by wiiich a superclass can declare an API for delegating 
to its suix'lasses. Rather than a sulxrlass just overriding its 
siiperciass's methods willy-niUy, in REALbasic, the code in the 
sufx.Tdass can explicitly issue calls to ctxie declared in its 
subclasses. 'Hus will veiy often significantly simplify 
maintenance, beratjse if you need to modify the superclass, you 
generally know wliat the subclasses will do as a result. Once you 
get used to it, explicit commimtcuion between parts of I fie class 
hierarchy just feels tigbi. 

Here is an exaitif jle of an abstract superclass and a concrete 
sulxlass, usiiig events. *t1iis code implements part of a collection 
of clinracter streams. 
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U ^ ^ ^ 


Functiorv Lejigiht} As Integer 
ralum Lfingth£vent () 

End Function 


I! 


Figure 4: Au ahsiraci few ckm, ChamaerPnnidtT 


Tlie example shows a method calling a New Eivni. New- 
Event declarations take exactly the .same fonn as interlace 
declarations, wliich is more or less w'hat they are. A New Emit 
speLine.s a sort of internal Al^l that code in subclasses can 
provide hooks for. Code in the parent class can then invoke any 
of its New Events in exactly the same way that it invokes a 
method. The parent class doesn't need to know any details of 
what tile sulx'las,s code does in response to the event, or where, 
how or even if the event is handled; it just ‘"delegates dt>wir. In 
the example sujierelass, all of the methtxJs are nothing more 
than one-liners that immediately invoke the corresponding 
event. Ibis i.s the standard w*ay to implement an af>straLl base 
class in RKAIbasic* 
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Figure 5: A suhclm% using Emits 


Figure 5 show%s a concrete .stjlxilass of the previous class 
that provides its characters fnnn a text file. Tlie screen shot 
shows code in one of the event handlers. Most of the code in 
this class is in its etKnn hnmilers, h\\\ it also adds an extra metlitxJ 
to set the file the instance of this ckiss will R*ad characters from. 

It is ptx\sil>le for a chain of subclasses to contribiiie to the 
liandllng of an event. It is not required that a siibclas.s provide a 
handler for an event it inherits. Ralher, the nufst immedkUe 
subclass that detlares a handier for an event ‘swallows' the 
event, l^jlocking low'er' suix’lasses from seeing it. But the 
subclass with the event handler c'an, in turn, re<leclare a New 
Event with the same name and arguments, and delegate further 
opportunities for behavior down the line. It can also define and 
ccill entirely new events, thus preseniing a richer or nuKlified set 
of behaviors for siilx lasses to extend fimlicT. 

Events cem lx: eitJjcT metluKl-siyle or functional (returning a 
value). A call to an unhandied mcilKxl-style event is just ignorcxl; 
calling an unhandled funciional event reiuras 0, an empty string. 
Nil or the like. 

The l)uill-in REALbusic classes use this paradigm for 
exteasion, and it is quite easy to implerneni, say, a sulxiass of 
the builtin text editing class that only lets the user enter 
nunilx:rs, but othenvi.se works the same, including invoking tlie 
same event handlers on any Fun lie r sulxrlass, in case such a 
.stihcla^ss needs ui modify tins lieliavior further. 

It's a demonstration of the clarity events bring to inheritance 
that one can almo.st always just take one event-based inheritance 
chain, ’'paste it’" ai the bottom of another, and it just works. It 
almost seems as tlioitgh this ought to make possible a form of 
event-based multiple inheritance in REAl.ha.sic, 

One of tlie built-in clas.ses is the (Muim control. This is 
essentially an empty control, providing a graphic's space info 
w'hicli a sulxiass can draw, and providing every ('onceivalsle 
kind of user imertace event for ihe ixmirol to rc^s|x>nd to. It is 
fon to take tbis bkmk slate and iiiipiemeni an interesting user 
interface control with its own display c'apabilities, events and 
metlKxls for furtlier subclasses to tlniw on. 

'Ibe event-based inheritance paradigm is, in short, a delight. 


72 


REALdasic Rumew 


MAdTECH • FeMI AKV 2004 









Pluj; in authoring and the C interface 

li if> fK)S,sil>lc U> drag cla^scK, cIuhs lueraR hicM and moduic.s 
from RCALbasic out to the file sy.^tem and into another project, 
including doing as a soft ‘‘link” to the file (so the project 
auLoimtically re-impons the file on laiint h, and any changes to 
the class are written out to the external file — great for classes 
shared l-Jetween projects). These exports can lie enciyjiied if you 
wish to make them available without revealing the source code. 
You can also choose whicli of dieir properties can be ^set in the 
IDE, if an instance of the class is dragged into a window. 

However, multiple classes — even in the same hierarchy — 
have to be exported as separate files, and have [a lie dragged 
into another project in a SLijierilasses“lielbre-sybc!as,ses order, or 
things break. ‘I'his is just stupid, has heen there since day one, 
and shows no sign of being fixed .sexm. 

1 would really like an ability to bundle up a class hicrareliy 
and export it as one object. Anti it's a pity 1 can't set a project to 
auiomaLically keep its entire contents as separate file.s, so 1 could 
use, say, CVS to manage tlie project (l)ut see die discussion of 
the Froject Manager, lielow). 

REALbasic also prcjvide.s a decent API lor writing your own 
[dug-ins in C. Uiifortuiialcly, the clwumentation for this hasn't 
kept up to dale with changes to REALba.sic. The documentation 
discusses making old-style resource-based plug-in using 
CodeWarrior on a Mac, The only deference to new fealurcs that 
1 could see was a change history, and a brief mention in the 
READMe lhai old-Format jilug-ins should be converted to the 
eurreni foniiaE using a supplied utility. 

1 understand that it is possible to author Window^s plug-ins 
using Visual Studio, hut this is essentially undocumented. You 
can work out how to do it by looking through fht^ mailing list 
archives and asking the right questions, but the document a tioii 
here really needs to be fixed. 


keep the code in a database, or make it downloadable. Used 
effectively, RBScTipt cx)ukl make a widely-deployed application 
unusually easy to supfKjri, upgrade and cusiomixe. 

Oelmgging and Profiling 

llEALba sit's debugger is decent, but nothing am axing. It 
offers the standard click-iO“pui-a4:)ieak[)oint in the left margin of 
the code editor, hut no easy way to find or temporarily disable 
the breakpoints you have. No ('ondtlinnal breakpoints £ although 
in 5.0, you cun issue a Break cumiuand to activate ihv 
debugger, so you can do whatever you like w'ith that). 

Onr:e you fire it up, the debugger is straightforward and 
effective (Figure 6). 
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Figure 6: The REALhusic Lk^hugger 


RliScript 

Another relatively unusual language feature: REAL Software 
developed the new compiler they inirodiiced in 5.0 by first 
developing “RBScript", which is essentially llie REAIhasic 
language compiler, without all the hooks into the IDE and the 
UK)lkit. This has heen developed into a built-in, compiled 
scripting language. The language is by default coiupleicly 
sandboxed — it canY access anything outside itself, Tlic 
developer can attach one ohjeci to the RBScript before 
compiling and running it, and the mLlluxl.s and properties of the 
ol:)ject are available as globals in the script. So you can un- 
sandbox any capability you wish, ami you can provide selective 
acce.ss to die rest of your applicadon cjuiLe easily. .Since it is also 
possible for the application to “coveilly” i>ut extra ctxle at the 
top of a user-supplied script, providing an arbitrary' numl:»er t)f 
ready-made t:las.ses and <nher features, it is entirely po.ssible to 
create an arl>iirarily full-featLircd scripting environment for a 
compiled KEALbasic application, w^ith comparatively little effon. 
This is a grtrat feature, and fm itching to try a project where I 
pul a lot of, say, lnjsine,ss logic into RBScript — I could even 


The debugger covers tlie basics: yim can see Lhe stack, your 
local variables, and globals. You can step over/inio/out. A nice 
touch is that you can set the debugger to automatically activate 
when any exception is raised. 

When yoLi click on a variable in the locals pane on the right 
side of the debugger, you get a nice little inspector (Figufe 7), 
and by clicking on object referenees (to open a new' inspector 
on that object in a new window), you can drill dowm diixiugh a 
data structure as far as you'd like. A little tlifficuit to .see the 
whole data slrucaiire thal way, but not bad. You can also mcxlify 
scalar values while the [m>gram is running. 
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Figure 7: An Object Inspector 

Kettiotc debusing 

For 53, HEAL Soflwarc is testing remole delmggiiig. This 
makes it possible to debug a prognmi running on one computer, 
from another computer, even running the debugger on a 
different platform to the one the program itself is mniiing on, or 
mnning the del>ugger remotely, via the InterneL This is a 
marvelous feature, and I hope it makes the cut for 5,5. 

No profiling 

Don't look for automated profiling, because there isn’t any. 
It's understandable, with the focus and style of REALbask, but 1 
think one of the best features a language can have is a good 
profiler, and I hope REAL looks into this before too long. 

No Project Browsing 

Seiiously missing in action Ls any means of browsing the 
class hierarchy. I find it hard to believe that L can't open a 
window and see a tree of the classes and sulx'lasses in ilie 
program. Finding where you are can be a significant problem in 
a ct^niplex pr()gram, 

5.5 adds a contextual menu c*hoice ibai takes you from a 
method call to its definition, so at least there is a link* progress 
on this front, 

Thk T<x)ijaT 

While REALba,sic's iratteries included” don’t approach those 
you1I find in, say, l^thon, you will find a very respectable and 
rapidly expanding collection of ready-u>go features '1n the 
tox”. ril discuss a few of die most imtxirtant features below, but 
here is a quick list of some other major features: 

• A fairly extensive set of Apple Event sending and receiving 
capabilities; 

• Extensive vector drawing primitives (including Bezier curves* 
rotated objecLs and text, grouping, and em|jloying bitmapped 


images as part of a vector drawing); 

• Fairly extensive bitmap manipulation primitives (through 
either Quanz — preiiy! or QuickDraw — fast!); 

• QuickTime editing of movies in code (surprisingly complete, 
including access to QuickTime effects); 

• Complete file system access, including randoTn-aecess read- 
write files, sequential access to files, getting and setting file 
and folder properties, and access to Resource Forks; 

• Full access to the keychain and the clipboard (apart, oddly, 
from tx:ing able to find what ariiilniry types of information 
are on the cliplxrard); 

• A fiist, raw McmoryBlock objeci type; 

■ A 3n sound class, with c]uiLe rich capabilities drawn from 
QuickTime; 

• Access to the Registry (on Windows); 

• Sending and receiving Afple EiMnLs: 

• Straightforward multi-threading (sadly, only on one 
processor), with semaphores and critiail sectioas; 

• Ability to control a shell, on both OS X and Windows 
{.stmngely, though, no support for Skiln, SldOut, or SidErr}; 

• Comprehensive POP/SMl'P Email sending and receiving, 
including with SSL (in the Professional release); 

• MTD* (with S,SL, in the Professional version) protocol 
supfjort for sending and receiving; 

• Regular Expressions (but not as part of the language — this 
is a set of classes you have to insianikite, set properties <m, 
and invtike — so not renujlely as convenient as in, say, 
PERL); 

• Fairly thorough support (I undersiand — my language skills 
are I i mi ted to the Roman alphabet) for text encoding and 
Unicode, 

DaTABASF. CLAPABlIJTIFJi 

REAlJiasic’s database capabililie.s are quite decent on the 
whole, although some gaps in the ''batteries inclucied” are 
disappointing. Also see Printing, bek>w, for a more serious 
obstacle uj database applicatums. 

REALbasic includes plug-ins giving suppoil for a nice range 
of common databases: 

• ODBC; 

• P{)stgreSQL; 

• Mv.SQL; 

• Dimension Server; 

• OpenBase: 

• FrontHase; 

• Sybase 

• Comma“separated files; 

• ,dbf (dBase) files; 

• dtfi 

• Oracle, 

REALbasic also includes a plug-in for a ctjmpetcnt l)asic 
single-user proprietary database format. 
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For databases not supporting SQL directly (moM notably» 
the built-in database and Dimension), RFALbasic provides an 
interpreter for a uscTiil-liut-small subset of the SQL language. 

Tliere is also a very good-looking third-party database plug¬ 
in available called VaUmiina that seems to Ix! getting a lot of 
attention in the RFALl^asic community. 

All of the database connections share their more imp(>!lant 
methods and properties and have a common iiasc class, so to 
the extent that your SQL code is portable l>etween databases, 
yt>ur REALbasic application can l>e switched from one type of 
database to another c[uite trivially, 

Access to the data is through a sLmdard cmsor-type object. 
Some standard .sfsecial-purpose interface controls and some 
special features of some of the general-purpose controls (such 
as the EditField anti the ListBcjx) make ii quite easy to put 
together a basic interface to scroll tlirough a list of records. 
doul>le click a row and go to a tIetaiJed view of a record, update 
fields, click throitgh records one at a time... The auloniuted 
features don't get in the way of doing some of the work yourself 
should you need sc^medimg out of the ordinarv'. Also, insofar as 
you can do your data manipulation through tlte one-record-at-a- 
timc cursor, you can make your ccxle even more independent of 
tlte particular underlying database. 

I wouldn't say tliat a RHALhasic damlxisc u.ser interface is 
remotely as tjuick to .set up as, say, a FileMaker interface. Hut ifs 
a couple of caders of magnitude more flexible without being 
anything like that much more work. 

On the other hand, if you want to develop a Gill database 
application of any complexity, you1I probably need some user- 
friendly query, import/export or cu.stomizahle reporting 
applications, and KBAiiiasic doesn’t come with anything like 
that. KFAlirasif provides everything you need to write those 
from scratcli, but doing a good job of these kinds of ap[>licalions 
would be a serious effon. 

Plug-ins may help here, Fve heard nice tilings alxjut 
dhRefxjfis (htip://www.abdatatools.com/dbrlndex.html), for 
Liser-customiziible reports. Iliere may well be similar alt<.:rnutives 
for the iinport/expon and querying, but after spending some 
time gcx)gling for them, 1 came up short. More on piug-hi 
availability below. 

Sadly, REALbasic doesn't take tlie opportunity to provide an 
object database, or anything else to help bridge the object- 
relational divide. 

Priming 

Far and away, the biggest problem you'd have doing a 
significant database applioiion (or, indeed, many kinds of 
programs) in RFj^Lbasic is printing. 

REALbasic provides only very low-level, QuickDniw-like 
printing capabilities. To print from a REAIbasic application, you 
get a special graphics object iaUi which your code draws, then 
you print it when you're done. 

The graphics drawing features of the REALbasic language 
provide gocxi basic capabilities for this — you can ask 


REAlJiasic to draw a string or sr>'led text into a box of a certiin 
width, and it then tells ycni w^hal height it was, for exatnple. But 
doing any kind of complex report in cxxlc like this is intractable 
foT the u(>wards of liundreds of reports you might have in a 
typical l^espoke database application. 

It's a great shame, Uxi, Ix’causc REALbasic would otherwise 
fie excellent for .such development. Dm is far and away the mo.st 
serious iiole in REALbasic’s feature set. 

1 imderstand that RFAI. Software is working on a new 
printing capafiilily, but it’s not kxiking like anything is going to 
appear in 5.5, at time of writing, 

MicROson Oi-i-icii Plug-ins 

Relatively unknown fact: Microsoft's Mac development team 
used REALbasic ro prototype ihe user interface for the last 
version of Internet Explorer for the Mac, and they continue to 
use REAlJ>asic, even publishing at least one part of the last 
version of Ottice written in REALbasic (lielow). 

Jt also appears as ihough Microsoft are w^irking witli REAL 
Software on a Microsoft Office automation plug-in for 
REALbasic. The feature isn't absohUely complete yet (particularly 
lacking the ability to imp events in Offit:e applications), but it 
can prolialily do anytliing youTe really likely to need the 
examples for the Flug-ins create and modify a Word document, 
create a PowerFoini presentation, import a picture into 
P()werPoini, and create an Excel .spread.sheet. The features 
already available can do most of what you are likely to need 
(automated creation of pretty reports, slideshows and 
spreadsheets from REALbasic). 

The cfxJe i.s alst:j tairly straightforward* 

RtiAU^^isk' ti)Uf tiJ crL-att' a Word dooimcni 
It is fairly straightforward to UJSe the Office Automation 
plug-in* 

Sub AetJonO 

din word as wordappHcation 
diin doc as worddocuroent 
dim style as wordstylo 
dim V as variant 

vord = new wordapplication 

doc “ word.dociiinefits.add 

doc,range.text = editfieldl.text 

V = doc.paragraphs.ItemtU.style 
if v*obJectvalue iaa worristyte then 
style word3tyle{v,obje£M.value} 
styletext.text = style.Ramelocal 
sty lefontnacne. text = style .font .name 
fltylefontsize.text str{style.font.size) 

end i f 

exception err as wordcxcept ion 
nsgbox err.message 
End Sub 

One very nice feature Ls Umt the same code should work on 
fx)ih MadnUxsh and Windows (mtxlulo some features that, at 
time of writing, had not been implemented on ihe Mac yet). 

Sadly, as with a few of the TTK)st interesting features of 
REALbasic, the documentation is woefully incomplete. A terse 
README or two and a few very simple examples constitute all 
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lljc liocumcntiition fm itwijrt? of. 1 think the It HAL Soft wart folks 
are expecting the deveitjjjcr to look ii> oiher VLsnal Bclkw for 
Apl>licatiom dcK'umeniaTion to fill in the blanks here (the plug¬ 
ins exploit RRALhasic's similarity to Visual Basic to re-implement 
virtually the same API). But ii would be nice if at least, they 
pointed the user to a good source for this informalit)n- 

Note that you can also exercise extensive control over a 
huge range of Madniosh and Window^s applicafions using Apple 
Events, AppleScrijX (below) or OLE. 

AppLRS^jRirr 

A grei4i feature is tlial you can compile an AppleScript 
method, drag the AppleScript file into REALl)as[c\ and just call il 
from your KF.A[>basic code, no other work required. This is a 
heck of an integration feature, a very tjuick and easy way of 
talking to all sorts of applications, and a very nice way of putiing 
a user interface on an AppleScript. 

NAIlVi; TOOLBOX CALLS 

On both Macintosh and Window.s, it is possible to access 
ttKillxix calls. Enough low-level hit-wrangling features are 
available (including Ixnng able to do thing.s like get handies for 
KKAIJxi.sic w^i^dows) that you can access most toollxix leatures 
if you know' what youTe doing. And if you don't, this featuie is 
the basis of a lot t)f cheap-or-free classes providing access to 
most OS leatures that aren’t already covered by REALbastc. 


On Windows, you can also call into DLl.s, and in 5.5, REAL 
is testing callbacks into REALbasic metlKxl.s fiir Ixith Macinto.sh 
and Windows. 

Ckoss-Plahorm Development 

REALbasic is liecoming one of the best ways around to 
w^riic cToss-platform cxxte. There is a funciionally eqLiivalent IDE 
for Windows, and you can compile to Window.s on the Mac or 
vice-versa (with the Professional version). Tlie inLcgration with 
Windows isn’t as complete as is the integration on the Mac, but 
it's pretty decent. In [>articular, the most important piece, being 
able to use OLE plug-ins, is there. 

For 5.5, REAL Software is beia-iesting a Linux compile. In 
developing their Windows version, REAL implemented 
compiling lor Window's on the Mac in early releases, following 
in later versions w'ith the Windows IDE. This is almost certainly 
what they’re doing for the Linux transition, which Targets GTK. 
Once they get the kinks out of the Linux compile, REALbasic will 
have a gotxl claim to being the best cross-platform CUI 
development sRiry around. 

Till- Company 

REAL Sofrw'are i.s a pretty pleasant company to deal with. 
They have a ctxiplc t^f very active developer email lists (one for 
the regular release, one for the betas), as well as a few' other lists 
for the likes of beginners and game developers. Virtually all of 
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lIic real Software staff post on the email lists from time to lime, 
and many of them post just about daily, including the president 
of the company, and all the develojK;n>. 

REAL Software ts very open wath its development prm'ess, 
putting regular development releases out general 
consumption, testing and dei>ate. And they're very good- 
humored alx>ut the inevitable problem with such a development 
strategy: people complaining, sometimes bitterly, about bugs in 
alpha and beta software. 

Tliey alst) liave an excellent bug tracking and feature 
requesting system, in the form of a wel>at:cessible database. You 
can add to it only after first searching for an existing rept)rt, and 
you c“an add comments to an existing report or 'Vote” on it, 
adding your weight to the need to address the report. And REAL 
does seem to try fairly hard to address ihe,sc things in order of 
popiilarily. 

There is a develoj^er’s program offering several tiers of 
ineinl:)ership, providing such things as expedited support. 

The Community 

REALbasic lx)asts a helpful and robust community, focused 
on the mailing lists. There are also a great ttuiny web sites 
concerned with REALlrasic, several Ixxiks, and quite a few 
developers sharing all manner of code, tutorials, plug-ins and 
other tools. 

On the other hand, there is no CPAN-type code library for 
REALbasic. Partly, this is the language design that doesn’t (ytrt) 
provide the sorts of features you'd need lo really easily share 
code (Pm thinking particularly of a real modules and 
namcspacc*s feature — some of the new features in 5.5 atv a 
good step in this direction). I^ut none of that is a shrjw-slopper 
— it could still he easier Xo find plug-ins, for example. 

Tliere is one site, rbgarage,com, chat is clearly aspiring to be 
a CPAN for REAlJxisic. It’s a nice site, (torly someone is putting 
in some effort here. It remains to lx.* seen whether tlicy will get 
the mtmienlum going to iKxxjuie the kind of canonical pt>int-of- 
origin that CPAN is, but 1 wish them well 

The Prck)!' in the Pi[Dding 

I always like to find out what real projects have lxx‘n 
written with a programming language. Wiihoiu funher ado: 

• Art Directors Tmlkit, a designer’s toolkit, which Apple 
bundles with all PowerMac G4 Towers and Powerb(K)k CA 
Liptops. 

• Miermoft Qaen^ for Mac OS X, which Open f)atabase 
Connectivity (ODBC) to allows you to imptjrt data from 
databases into Microsoft Excel X. 

• Aulo-HhLstralor, an "ext)erimentai, semi-autononious, 
generative software artwork and a fully funitional vecior 
graphic design applictuion to sii alongside your existing 
professional graphic design utilities”. 

• Whistle Blou^er, a server monitor and functional testing iiiiliry. 


• InleUimerge, e-mail iiieige software for Mac OS X and Mac 

• Coldstone (jamlng Engine, an easy to use game development 
ux>l LliiiL allows you to create professional stand-alone games 
that run on Mac OS, Mac OS X, and Microsoft Window^s. 

• ^-OA'- Wings o/Mercufy, a reuli.stic simulation of the Mercury 
spacecraft. 

• SpamFire, An anti-spam email filter. 

• Medialuiit, a movie and gniphic editing L(X)L 

What you get 

REALbasic conies in iwo versions (Standard and 
Professional) for two platforms (Macintosh — Native and Classic, 
and Windows). 

*rhe extras in the ProfeSsSionai version are: 

• Cnxss-platfonn compiles; 

• The database features; 

• SSL for the Internet Features; anti 

• a Ix^ater "server” version of networking scK'kets. 

In the US. at time t^f writing, a Suintlard version can tx^ had 
for $99.95, and Prt>fe,ssit>nal for S399.95. That’s for the 
download-only version. A little more gels you over KXX) pages 
of dead tree dcx:umentation and a CD. Hiere is also a somewhat 
more expensive version that gets you a year of upgrades. 

Upgrades from die previous version are $79.95 (Standard) 
and $169-95 (PrDfe^s.sional). if you’re stTious alxua REALbasic, 
the subscription is a nonarivial saving on the upgrade. 

There arc also some Academic pricing options, volume 
[xircliase options, and the like. 

Conclusion 

You could call high-level languages ;m obsession of mine. 
! ve tried many, many languages. Cximpared to RHALl>a.sic, IVe 
tried Deeper languages (Scheme, Dylan), mom liroaclly accepted 
languages (C++ Python, PERL, ...), languages that are easier to 
use (Pytlx)n), ;inti languages with IxfUer IDEs (Java with Eclipse 
or Objective C with Projecl Builder). 

Bill I've not used any language or IDE that makes gcxxl 
GUIs easier to constnict than dex^s REALbasic. Thai w'ould Iki a 
great argument for REALbasic t>n its own, but live clincher for me 
is ihai REALl>ask score.s a ccmsisteni "really, pretty decenU on 
depth, acceptance, ea.se of use, and the IDE — something I 
wouldn't say for any other language 1 k^o^^^ 

REALbasic is an erfective uk) 1 for either lieginnei's or expert.s 
and it's fun to work with. As long a.s its one really major 
limitation (printing) isn't a problem lor you, ifs a g^xx! candidate 
for a very brcxid range of devclofiment projeas. 
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Start the New Year Right! 


Achieve your new year's resolutions with help from these great guides 
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on eBay. It's all here! 
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Second Edition 
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0-321‘22468-X • $29.99 • 560 pages 
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Guide to Customizing Your Computer 
and Other Digital Devices 

By Joshua "Yoshi" DeHerrera 
0-7357*1405-3 • $15.99 • 176 pages 

» Macromedia Flash MX Professional 
2004 for Server Geeks 

By Nate Weiss 

0-7357-1382-0 • $45.00 • 624 pages 

»TechTV's Guide to the Golf 
Revolution: How Technology is 
Driving the Game 
By Andy Brumer 
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» Sell it on eBay: TechTV's Guide to 
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By Jim Held and Toby MaNna 
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» Mac OS X Panther Killer Tips 
By Scott Kelby 

0-7357-1393-6 • $29.99 • 275 pages 
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as a Peachpit Club Member, and save 10% on top 
of that with this one-time coupon! Simply go to 
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code EM-J4AA-MTMF at checkout, irs that easy! 
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■ Common API across all platforms and hardware 

■ Hardware-based code and data encryption 


Protection Kit and find 
small software companies to Fortune 500 
switching to the WIBU-KEY Security, not Obscurity model 
all of their software licensing needs, including: 


■ Field-upgradable and reusable hardware 

■ The most cost-effective network licensing solution available 

■ The only system to employ RID/RED and AXAN security 

■ Engineered and manufactured to exacting ISO9001 standards 
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Revolution 2.1: the English like language 
designed around the way you think. 

Develop and deliver on T4 platforms, including Mac OS X, Windows and Linux. 
Now with support for XML, additional SQL databases, video capture, Unicode, 
Reports, enhanced faceless CGI applications, and more. 

And now from Dan Shafer, the first "how to" book on Revolution. 

Get a headstart with “Revolution; Software at the Speed of Thought", 
volume one now shipping from www.runrev.com/revpress. 

Thousands of developers have already joined the Revolution. Can you afford to wait? 
Pricing starts at $149. Don't let the revolution in coding start without you. 
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